Executive Summary
Summary
Docs.sui.io saw 5,051 visitors and 15,408 pageviews in the week of April 9–15, 2026, with improving engagement metrics and 75 Kapa conversations revealing friction in gRPC/SDK migration, Move basics, and DeepBook setup. Seven distinct developer pain-point themes emerged, all requiring targeted documentation improvements.
Priority 1
Publish gRPC/GraphQL migration guidance to address the highest-volume SDK friction theme spanning 11+ conversations.
Priority 2
Create a Move basics and object model FAQ to convert high-traffic onboarding pages into successful developer journeys.
Priority 3
Add DeepBook BalanceManager and Seal session key quickstarts to serve the demonstrably high-engagement DeepBook audience.
Priority 4
Fix or expand Programmable Transaction Blocks content to reduce the 66% bounce rate on that high-traffic page.
Traffic Overview
Over the 7-day period April 9–15, 2026, docs.sui.io attracted 5,051 visitors generating 15,408 pageviews, with a 64% bounce rate and average session duration of 184 seconds. Traffic is trending positively in the latter half of the week, with engagement (views per visit and session duration) slightly improving week-over-week compared to the prior 7-day period. The getting-started funnel dominates page traffic, and organic/direct sources account for the majority of visits.
Weekend Traffic Dip
Visitors dropped sharply on April 11–12 (582 and 570 respectively) versus weekday peaks above 660–1,127, confirming a developer-heavy audience with weekday usage patterns.
Improving Engagement Week-over-Week
Views per visit rose from 2.47 (14d) to 2.7 (7d) and avg session duration increased from 159s to 184s, suggesting recent content or promotion is attracting more engaged users.
Strong Getting-Started Funnel
The top 10 pages are dominated by getting-started guides (install, configure, hello-world, get-coins, get-address), indicating docs.sui.io is primarily serving new developer onboarding.
AI Chatbot Referral Emergence
ChatGPT (48 visitors) and Claude (8 visitors) together sent 56 visitors this week. While still small, this signals a growing channel of AI-assisted developer discovery that warrants monitoring.
DeepBook Ecosystem Engagement
deepbook.tech referrals (89 visitors, 268s duration) and the /standards/deepbook page (140 visitors, 17% bounce rate) both show unusually high engagement, pointing to active DeepBook developer activity.
Top 20 Pages
| # | Page | Insight |
|---|---|---|
| 1 | / | Top page with 1,341 visitors and 1,822 pageviews, 34% bounce rate — well below site average, meaning homepage visitors actively continue browsing. |
| 2 | /guides/developer/getting-started/sui-install | 704 visitors and 1,106 pageviews; the most-visited content page, confirming strong new-developer onboarding demand. |
| 3 | /guides/developer/getting-started/configure-sui-client | 180 visitors but 330 pageviews (high recurrence), 38% bounce rate — users return to this reference page repeatedly during setup. |
| 4 | /guides/developer/getting-started/install-source | 152 visitors, 280 pageviews, low 22% bounce rate — highly engaged readers likely working through source installation steps carefully. |
| 5 | /sui-api-ref | 158 visitors and 280 pageviews, 29% bounce rate — strong API reference engagement, suggesting active developers querying endpoints. |
| 6 | /standards/deepbook | 140 visitors, 17% bounce rate — among the lowest on the site, indicating DeepBook users are highly engaged and exploring deeply. |
| 7 | /guides/developer/transactions/ptbs/prog-txn-blocks | 181 visitors but only 29 seconds avg time on page and 66% bounce rate — high drop-off suggests content may not be meeting user expectations. |
| 8 | /concepts/data-access/grpc | 134 visitors with a 24% bounce rate — gRPC data access content resonates well; low bounce suggests it serves as a gateway to further reading. |
| 9 | /guides/developer/digital-assets/migrate-address-balances | 98 visitors with 61% bounce rate — likely driven by a specific migration need; worth monitoring for spikes tied to ecosystem events. |
| 10 | /concepts/tokenomics/tokenomics-overview | 110 visitors, 49% bounce rate — steady tokenomics interest, potentially from investors or stakers researching the ecosystem. |
Referral Sources
| Source | Type | Insight |
|---|---|---|
| Direct / None | Organic | 2,646 visitors (largest source), 71% bounce rate, 152s avg duration — direct traffic dominates, typical for a docs site bookmarked by developers. |
| Organic | 1,206 visitors with the lowest bounce rate among top sources (58%) and highest avg duration (234s) — search-driven users are highly engaged and task-oriented. | |
| sui.io | Organic | 529 visitors referred from the main Sui website, 44% bounce rate — strong internal funnel from marketing site to docs. |
| Bing | Organic | 210 visitors, 77% bounce rate — high bounce suggests Bing searchers are less targeted; content-search alignment may need improvement for this audience. |
| deepbook.tech | Organic | 89 visitors with 51% bounce rate and 268s avg duration — DeepBook ecosystem users are highly engaged readers when they arrive. |
| docs.sui.io | Organic | 87 self-referrals with 47% bounce rate and 496s avg duration — internal cross-linking is driving deep reading sessions. |
| chatgpt.com | AI / Chatbot | 48 visitors via ChatGPT with 72% bounce rate and 112s duration — AI assistant users arrive with specific questions but tend not to browse further. |
| claude.ai | AI / Chatbot | 8 visitors from Claude with 50% bounce rate and 395s avg duration — small but highly engaged cohort; AI-referred users spending significant time on content. |
| GitHub | Organic | 63 visitors, 45% bounce rate, 392s avg duration — GitHub-referred developers are among the most engaged, likely following links from READMEs or issue threads. |
| blog.sui.io | Organic | 74 visitors from the Sui blog with a very low bounce rate (73%) — the MoveRegistry interoperability announcement blog post is a notable driver (67 visitors from that specific URL). |
chatgpt.com
48 visitors with 72% bounce rate and 112s avg duration; AI users arrive with narrow questions and rarely browse further.
claude.ai
8 visitors with 50% bounce rate and 395s avg duration; a small but highly engaged cohort spending nearly 4 minutes per session.
Top Referrer URLs
Exact referring URL or domain and the number of visits driven from each. Direct (no referrer) is excluded.
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 Client and TypeScript/Python SDK Usage | Low 24% bounce confirms engaged users still lack BCS/codegen answers found in Kapa. |
| /guides/developer/getting-started/sui-install | Sui Move Basics and Object Model | 704 visitors onboarding align with 9 beginner Move questions hitting Kapa weekly. |
| /guides/developer/getting-started/configure-sui-client | Move Package Management, Publishing, and CLI Errors | High recurrence (330 pageviews, 180 visitors) mirrors CLI publish error confusion in Kapa. |
| /standards/deepbook | DeepBook V3 and Seal/zkLogin Integration Errors | 17% bounce and 140 visitors signal deep intent unmet by current BalanceManager docs. |
| /sui-api-ref | JSON-RPC to gRPC/GraphQL Migration | Active API reference use correlates with 9 migration-mapping questions in Kapa. |
| /guides/developer/transactions/ptbs/prog-txn-blocks | Sui Move Basics and Object Model | 66% bounce and 29s dwell suggest PTB content fails beginners asking object-model questions. |
| /concepts/tokenomics/tokenomics-overview | Stablecoin Integration and Transaction Data Extraction | Tokenomics traffic co-occurs with USDC/USDT faucet and balanceChanges questions in Kapa. |
| /guides/developer/digital-assets/migrate-address-balances | JSON-RPC to gRPC/GraphQL Migration | Migration-specific page traffic reinforces demand for consolidated RPC-to-gRPC checklists. |
Notable Takeaways
PTB Page Loses Visitors in Under 30 Seconds
29 seconds average time on page; 66% bounce rate; 181 visitorsDevelopers land on the PTB page with intent but leave almost immediately, indicating a critical content-expectations mismatch.
DeepBook Drives Disproportionate Cross-Signal Engagement
89 referral visitors from deepbook.tech at 268s duration; 140 page visitors at 17% bounce; 8 Kapa conversations on BalanceManager errorsDeepBook is an active developer hotspot where high engagement meets unresolved setup friction, amplifying documentation impact.
Claude-Referred Users Outperform All Other AI Sources by Session Depth
395 seconds avg session duration from claude.ai vs. 112 seconds from chatgpt.comDespite only 8 visits, Claude referrals produce the deepest reading sessions of any AI source, suggesting high-intent queries.
gRPC SDK Theme Is the Single Largest Kapa Pain Point
11 Kapa conversations on gRPC client and SDK usage out of 75 total (15% of all conversations)SDK-layer friction is the most frequent developer blocker and is underserved by current gRPC documentation.
Developer Pain Point Themes
This week's 75 conversations span gRPC/GraphQL migration, Move development basics, DeepBook setup, GraphQL pagination issues, and Seal/zkLogin errors. Key friction points include API migration complexity, cursor-based pagination confusion, and foundational Move/object model questions from new developers.
gRPC Client and TypeScript/Python SDK Usage
BCS parsing and codegen gaps block developers from completing core data-access integrations.
JSON-RPC to gRPC/GraphQL Migration
No consolidated migration reference forces developers to reverse-engineer deprecated-to-new method mappings.
Sui Move Basics and Object Model
Unanswered beginner questions stall onboarding and inflate repeat Kapa volume.
Move Package Management, Publishing, and CLI Errors
Publish-time errors with no troubleshooting reference cause developers to abandon workflows mid-cycle.
DeepBook V3 and Seal/zkLogin Integration Errors
Missing flow docs for BalanceManager and Seal produce 403 errors that block production integrations.
Sui GraphQL Pagination and Cursor Handling
Cursor/digest conflation breaks paginated queries and is a recurring, preventable error pattern.
Recommended Actions
Build gRPC SDK Quickstart with BCS, Codegen, and BatchGetObjects Examples
Expand /concepts/data-access/grpc with TypeScript and Python code samples covering BCS parsing, codegen setup, and BatchGetObjects limits.
11 Kapa conversations make this the single highest-volume pain point this week.
Publish JSON-RPC to gRPC/GraphQL Migration Checklist
Create a standalone migration guide mapping deprecated RPC methods to gRPC/GraphQL equivalents with working code snippets.
9 Kapa conversations and active /sui-api-ref traffic confirm developers are mid-migration with no consolidated reference.
Create Move Basics FAQ Covering Ownership, Object IDs, and Transfer Patterns
Add a beginner FAQ page linked from /guides/developer/getting-started/sui-install covering structs, ownership types, and transfer mechanics.
704 weekly install-page visitors feed directly into 9 unanswered beginner Kapa conversations.
Add DeepBook BalanceManager and Seal Session Key Quickstarts
Write step-by-step quickstart guides for BalanceManager initialization and Seal browser-wallet session key signing flow.
8 Kapa conversations on 403 errors and 140 deeply engaged /standards/deepbook visitors need actionable setup docs.
Add GraphQL Cursor Pagination Guide with Opaque endCursor Examples
Create a dedicated pagination reference page clarifying opaque cursors versus tx digests with affectedAddress query samples.
7 Kapa conversations show this is a recurring, preventable misunderstanding with a straightforward documentation fix.
Instrument AI Referral Traffic for Ongoing Chatbot Channel Monitoring
Set up a Plausible segment or dashboard filter tracking chatgpt.com and claude.ai referral trends weekly.
56 AI-referred visitors this week with divergent engagement patterns warrant structured tracking before the channel grows further.
Rewrite Programmable Transaction Blocks Page to Match User Intent
Audit and restructure /guides/developer/transactions/ptbs/prog-txn-blocks with clearer entry points and progressive examples.
29-second dwell time and 66% bounce on a high-traffic page signals immediate content failure.