Executive Summary
Summary
docs.sui.io recorded 5,051 unique visitors and 15,408 pageviews for the week of Apr 9–15, 2026, with engagement metrics improving week-over-week. Analysis of 61 Kapa conversations identified 7 distinct themes, with gRPC/API migration and GraphQL transaction fetching as the dominant developer pain points. Getting-started content dominates traffic while DeepBook and zkLogin pages show disproportionately high engagement depth.
Priority 1
Publish a unified JSON-RPC to gRPC/GraphQL migration guide to address the highest-volume Kapa theme (17 conversations).
Priority 2
Fix or expand the Programmable Transaction Blocks page, which shows high traffic (181 visitors) but very low time-on-page (29s) and 66% bounce.
Priority 3
Create a canonical GraphQL transaction-fetching reference to resolve repeated cursor and balance reconstruction misuse (13 conversations).
Priority 4
Expand the Kapa knowledge base to cover Walrus, SEAL, VRF, and liquid staking, which account for 9 unanswered conversations.
Traffic Overview
docs.sui.io saw 5,051 unique visitors and 15,408 pageviews over the 7-day period (Apr 9–15, 2026). Engagement is moderate with a 64% bounce rate, 2.7 pages per visit, and an average session duration of 184 seconds. Traffic is up in the most recent 7 days compared to the prior week (5,051 vs ~4,779 implied from the 14d total), suggesting a slight positive trend. Getting-started content dominates page consumption, and direct traffic plus Google are the primary acquisition channels.
Weekday vs. Weekend Traffic Drop
Visitors dipped sharply on Apr 11–12 (Sat–Sun) to 582 and 570 respectively, versus 822–1,127 on weekdays. This confirms a developer-skewed audience that accesses docs primarily during work hours.
Getting-Started Funnel Dominates Consumption
The top 8 pages by pageviews are all homepage, getting-started, or core concepts pages, indicating the majority of traffic is new or early-stage developers onboarding to Sui rather than experienced builders seeking advanced references.
AI Chatbot Referrals Emerging
ChatGPT (48 visitors) and Claude (8 visitors) together account for 56 AI-referred visitors this week. While still a small share, this signals growing use of LLMs to navigate to official docs—a channel likely to grow.
Engagement Improving in Most Recent Week
The 7-day window shows higher views/visit (2.7 vs 2.47 over 14d) and longer session duration (184s vs 159s), suggesting recent content updates or a higher-intent visitor cohort arriving this week.
DeepBook Content Punches Above Its Weight
Between /standards/deepbook (17% bounce, 61 scroll), /standards/deepbook-margin (3% bounce!), and deepbook.tech referrals (268s duration), DeepBook-related content consistently shows the highest engagement signals on the site.
Top 20 Pages
| # | Page | Insight |
|---|---|---|
| 1 | / | Top page with 1,341 visitors and 1,822 pageviews. Low-ish bounce (34%) and solid scroll depth (68%) suggest it effectively routes users deeper into the docs. |
| 2 | /guides/developer/getting-started/sui-install | Second most visited page (704 visitors, 1,106 pageviews). High scroll depth (62%) confirms users are reading installation instructions thoroughly. |
| 3 | /guides/developer/getting-started/configure-sui-client | 180 visitors with good scroll depth (67%), part of the getting-started funnel following installation—indicates a healthy sequential flow. |
| 4 | /guides/developer/getting-started/hello-world | 229 visitors with 44% bounce; users completing the install flow are progressing to the Hello World tutorial as expected. |
| 5 | /standards/deepbook | 140 visitors with very low bounce (17%) and high scroll depth (61%), indicating strong engaged interest in DeepBook standards content. |
| 6 | /concepts/data-access/grpc | 134 visitors, 24% bounce, 43 scroll depth—low bounce suggests this is a destination page for developers actively integrating gRPC data access. |
| 7 | /guides/developer/digital-assets/migrate-address-balances | 98 visitors with 61% bounce and moderate scroll (36%)—notable traffic to a migration guide, possibly driven by a recent protocol change or announcement. |
| 8 | /guides/developer/transactions/ptbs/prog-txn-blocks | 181 visitors but 66% bounce and only 29s time-on-page, suggesting users may not be finding what they need—a candidate for content improvement. |
| 9 | /references/fullnode-protocol | 110 visitors with 49% bounce; operator/node runner audience is actively referencing protocol specs. |
| 10 | /guides/developer/cryptography/zklogin-integration/zklogin | 96 visitors with 53% bounce; zkLogin integration remains a consistent area of developer interest. |
Referral Sources
| Source | Type | Insight |
|---|---|---|
| Direct / None | Organic | Largest source at 2,646 visitors (52% of total). High direct traffic is common for developer docs bookmarked or accessed via IDE/terminal links. |
| Organic | 1,206 visitors with low bounce (58%) and strong 234s duration—organic search visitors are highly engaged and finding relevant content. | |
| sui.io | Organic | 529 visitors referred from the main Sui website, confirming effective cross-linking between the marketing site and docs. |
| Bing | Organic | 210 visitors with 77% bounce—Bing traffic is lower quality with much higher bounce than Google, suggesting weaker query-content alignment. |
| deepbook.tech | Organic | 89 visitors with low bounce (51%) and the highest avg duration among referrals at 268s, indicating highly motivated DeepBook developers. |
| docs.sui.io | Organic | 87 self-referrals likely from anchor links or redirects within the docs site itself; long avg duration (496s) suggests deep reading sessions. |
| GitHub | Organic | 63 visitors with 45% bounce and 392s duration—GitHub-referred developers are among the most engaged, spending significant time reading docs. |
| chatgpt.com | AI / Chatbot | 48 visitors referred from ChatGPT, confirming AI assistant-driven traffic is a real and emerging channel for docs.sui.io. |
| claude.ai | AI / Chatbot | 8 visitors from Claude with 50% bounce and 395s duration—small but highly engaged AI-referred segment, worth monitoring for growth. |
| Organic | 18 visitors with 50% bounce but exceptional 624s duration—tiny sample but surprisingly deep engagement from social referrals. |
chatgpt.com
48 visitors referred from ChatGPT, making it the largest AI-driven referral source and a confirmed emerging channel.
claude.ai
8 visitors from Claude with 50% bounce and 395s duration, indicating small but highly engaged AI-referred users.
Page ↔ Kapa Theme Correlations
High-traffic pages mapped to the Kapa themes they correspond to.
| Page | Related Kapa Theme | Insight |
|---|---|---|
| /concepts/data-access/grpc | gRPC and JSON-RPC Migration | High-traffic gRPC page (134 visitors, 24% bounce) aligns with the top Kapa theme of 17 conversations on RPC migration. |
| /guides/developer/getting-started/sui-install | Sui Move Basics and Core Concepts | Installation page traffic (704 visitors) correlates with the beginner cohort driving 9 Move basics Kapa conversations. |
| /guides/developer/getting-started/hello-world | Sui Move Basics and Core Concepts | Hello World visitors (229) likely overlap with beginners asking Move object and ownership questions in Kapa. |
| /standards/deepbook | DeepBook V3 and DeFi Integration | DeepBook page's very low bounce (17%) mirrors Kapa questions on BalanceManager and payWithDeep configuration. |
| /guides/developer/cryptography/zklogin-integration/zklogin | zkLogin Address and JWK Rotation Issues | zkLogin page (96 visitors, 53% bounce) aligns with 3 Kapa conversations on JWK rotation and address derivation. |
| /guides/developer/transactions/ptbs/prog-txn-blocks | Sui GraphQL Pagination and Transaction Fetching | PTB page's high bounce (66%) and 29s time-on-page suggest users aren't finding transaction construction answers. |
| /guides/developer/getting-started/configure-sui-client | gRPC and JSON-RPC Migration | Client configuration page (180 visitors) likely serves developers mid-migration needing endpoint setup guidance. |
| /references/fullnode-protocol | gRPC and JSON-RPC Migration | Fullnode protocol reference (110 visitors) is a natural destination for developers mapping deprecated RPC methods. |
| /guides/developer/digital-assets/migrate-address-balances | Sui GraphQL Pagination and Transaction Fetching | Migration guide traffic (98 visitors) correlates with Kapa confusion around balance reconstruction from GraphQL. |
| /guides/developer/getting-started/sui-install | Package Management, Publishing, and Upgrades | Install page funnel visitors may progress to publishing workflows where 11 Kapa conversations surface errors. |
Notable Takeaways
PTB Page Has High Traffic but Near-Zero Engagement
181 visitors, 66% bounce rate, and only 29 seconds average time-on-page for /guides/developer/transactions/ptbs/prog-txn-blocks.Users are landing on this page seeking answers but leaving immediately, signaling a significant content gap or mismatch.
gRPC Migration Is the Top Unmet Developer Need
17 of 61 Kapa conversations (28%) this week focused on mapping deprecated JSON-RPC methods to gRPC or GraphQL equivalents.No single migration reference exists, forcing developers to ask repetitive questions instead of self-serving.
GraphQL Cursor Misuse Is Causing Repeated Support Load
13 Kapa conversations involved incorrect use of raw tx digests as cursors and failed balance reconstruction from GraphQL responses.The current GraphQL docs lack a complete working example covering cursors, balanceChanges, and gas fields together.
DeepBook Content Shows Strongest Engagement Signals on Site
/standards/deepbook has 17% bounce and 61% scroll depth; deepbook.tech referrals average 268s session duration.DeepBook developers are highly motivated but Kapa shows 3 conversations stuck on BalanceManager and payWithDeep setup.
9 Kapa Conversations on Ecosystem Topics Went Unanswered
9 conversations about Walrus, SEAL, VRF, liquid staking, and testnet stablecoins returned no useful Kapa answers.These knowledge gaps force developers to seek help in community channels, increasing support burden unnecessarily.
Developer Pain Point Themes
This week's 61 conversations reveal strong developer interest in gRPC/API migration, transaction data fetching correctness, and Move basics. Recurring pain points include GraphQL pagination, package publishing errors, and unanswered ecosystem questions.
gRPC and JSON-RPC Migration
Deprecated RPC methods leave developers blocked without a clear migration path to supported endpoints.
Sui GraphQL Pagination and Transaction Fetching
Cursor misuse and balance reconstruction errors cause incorrect transaction data in developer applications.
Package Management, Publishing, and Upgrades
Publishing errors and package ID confusion block developers from deploying and iterating on Move contracts.
Sui Move Basics and Core Concepts
A strong beginner cohort lacks a structured path through objects, abilities, ownership, and events.
Unanswered Ecosystem Questions (Walrus, SEAL, Stablecoins)
Unanswered questions erode developer trust in docs and push support load to community channels.
DeepBook V3 and DeFi Integration
Mandatory configuration steps like payWithDeep are underdocumented, blocking DeFi integrations at a critical step.
zkLogin Address and JWK Rotation Issues
JWK rotation can silently invalidate ZK proofs, causing production authentication failures for developers.
Recommended Actions
Create JSON-RPC to gRPC/GraphQL Migration Mapping Guide
New dedicated page mapping each deprecated JSON-RPC method to its gRPC or GraphQL equivalent with code samples.
17 Kapa conversations this week—28% of total—are blocked on this exact missing reference.
Rewrite Programmable Transaction Blocks Page
Full content audit and rewrite of /guides/developer/transactions/ptbs/prog-txn-blocks with concrete examples.
181 visitors landed this week but 66% bounced after only 29 seconds, signaling severe content mismatch.
Publish Canonical GraphQL Transaction-Fetching Code Example
New reference example covering correct cursor pagination, balanceChanges fields, and gas reconstruction in Python/TypeScript.
13 Kapa conversations repeat the same cursor misuse and balance errors due to absent working examples.
Build a Unified Package Lifecycle Guide
Single guide covering Move package build, publish, upgrade, address tracking, and common error resolution.
11 Kapa conversations hit 'already published' errors and package ID confusion with no consolidated reference.
Add DeepBook V3 Quickstart with Mandatory Config Steps
New quickstart page emphasizing payWithDeep:true and BalanceManager initialization as required first steps.
High DeepBook page engagement (17% bounce) meets Kapa gaps on mandatory but underdocumented configuration.
Document zkLogin JWK Rotation Risks and Address Derivation
Expand zkLogin guide with JWK rotation impact section and a multi-user address derivation example using aud, sub, and salt.
3 Kapa conversations and 96 weekly page visitors indicate active zkLogin integration with underdocumented edge cases.
Expand Kapa Knowledge Base for Walrus, SEAL, VRF, and Liquid Staking
Index existing Walrus, SEAL, VRF, and liquid staking documentation into Kapa and create stub pages where gaps exist.
9 ecosystem conversations went fully unanswered this week, actively degrading developer trust in the chatbot.
Create Structured Move Beginner Learning Path
Curated sequential learning path linking objects, abilities, ownership types, events, and transactions for new developers.
9 Kapa beginner conversations and dominance of getting-started pages (704 install visitors) confirm a large new-developer cohort.