# GitBook guides

<h2 align="center">GitBook guides</h2>

<p align="center">Looking to improve your documentation workflows? Our guides are packed with advice, tips and best practices for GitBook and beyond.</p>

<p align="center"><button type="button" class="button primary" data-action="ask" data-icon="gitbook-assistant">Ask a question...</button></p>

### Featured guides

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover-dark data-type="image">Cover image (dark)</th></tr></thead><tbody><tr><td><h4>The complete guide to publishing documentation in GitBook [updated for 2025]</h4></td><td><a href="https://1940848424-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLBGJKQic7BQYBXmVSjy0%2Fuploads%2Fwiqeu8GSa77cVudGU6SI%2Fcomplete-guide-to-publishing-with-gitbook.png?alt=media&#x26;token=3a8548e6-88cb-4b6e-9613-68bd0e49a9a7">complete-guide-to-publishing-with-gitbook.png</a></td><td><a href="editing-and-publishing-documentation/complete-guide-to-publishing-docs-gitbook">complete-guide-to-publishing-docs-gitbook</a></td><td><a href="https://1940848424-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLBGJKQic7BQYBXmVSjy0%2Fuploads%2FusCBBpC9jQTccbiH2nm7%2Fcomplete-guide-to-publishing-with-gitbook-1.png?alt=media&#x26;token=7114d81d-4809-4416-9798-8c86f4fae08f">complete-guide-to-publishing-with-gitbook-1.png</a></td></tr><tr><td><h4>Documentation analytics: which metrics to track and how to measure success</h4></td><td><a href="https://1940848424-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLBGJKQic7BQYBXmVSjy0%2Fuploads%2FhkZEss7xrJxJi3jNiUAe%2Fdocumentation-analytics.png?alt=media&#x26;token=5cb1c5b9-70ec-46b6-aa15-d8f4c864513b">documentation-analytics.png</a></td><td><a href="docs-analytics/documentation-analytics">documentation-analytics</a></td><td><a href="https://1940848424-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLBGJKQic7BQYBXmVSjy0%2Fuploads%2FpbBmS1YOvXUwi4K27Vdu%2Fdocumentation-analytics-1.png?alt=media&#x26;token=1cdc7705-15bb-4fe4-ab48-a493d0a869ec">documentation-analytics-1.png</a></td></tr><tr><td><h4>The seven principles of great API docs and how to apply them</h4></td><td><a href="https://1940848424-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLBGJKQic7BQYBXmVSjy0%2Fuploads%2FpiIv4IWDKoN7QPz37ntF%2Fseven-principles-of-great-api-docs.png?alt=media&#x26;token=313faf5d-c987-40fc-8c04-940f3766de5d">seven-principles-of-great-api-docs.png</a></td><td><a href="api-documentation/api-documentation-principles">api-documentation-principles</a></td><td><a href="https://1940848424-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLBGJKQic7BQYBXmVSjy0%2Fuploads%2FnQ1osTifhi4KKFSrbFXF%2Fseven-principles-of-great-api-docs-1.png?alt=media&#x26;token=4345e848-67f3-4bc2-a4c8-85cd4d64d812">seven-principles-of-great-api-docs-1.png</a></td></tr></tbody></table>

### Categories

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h3><i class="fa-globe-pointer">:globe-pointer:</i></h3></td><td><h4>Editing &#x26; publishing documentation</h4></td><td>Publish, customize and change site settings</td><td><a href="editing-and-publishing-documentation">editing-and-publishing-documentation</a></td></tr><tr><td><h3><i class="fa-brush">:brush:</i></h3></td><td><h4>Customizing your docs site</h4></td><td>How to set your site’s theme, add branding and configure options</td><td></td></tr><tr><td><h3><i class="fa-window-restore">:window-restore:</i></h3></td><td><h4>Content organization &#x26; localization</h4></td><td>Improve your site’s layout and structure</td><td><a href="content-organization-and-localization">content-organization-and-localization</a></td></tr><tr><td><h3><i class="fa-brain-circuit">:brain-circuit:</i></h3></td><td><h4>SEO &#x26; LLM optimization</h4></td><td>Tips and best practices for being cited consistently</td><td><a href="seo-and-llm-optimization">seo-and-llm-optimization</a></td></tr><tr><td><h3><i class="fa-clipboard-list-check">:clipboard-list-check:</i></h3></td><td><h4>Docs workflow optimization</h4></td><td>Improve the way you and your team work</td><td><a href="docs-workflow-optimization">docs-workflow-optimization</a></td></tr><tr><td><h3><i class="fa-rectangle-terminal">:rectangle-terminal:</i></h3></td><td><h4>API documentation</h4></td><td>How to create unbeatable API docs</td><td><a href="api-documentation">api-documentation</a></td></tr><tr><td><h3><i class="fa-chart-line-up">:chart-line-up:</i></h3></td><td><h4>Docs analytics</h4></td><td>How to measure success for your docs</td><td><a href="docs-analytics">docs-analytics</a></td></tr><tr><td><h3><i class="fa-users">:users:</i></h3></td><td><h4>Docs personalization &#x26; authentication</h4></td><td>Tailor your docs for specific users &#x26; groups</td><td><a href="docs-personalization-and-authentication">docs-personalization-and-authentication</a></td></tr><tr><td><h3><i class="fa-octagon-check">:octagon-check:</i></h3></td><td><h4>Best practices</h4></td><td>General tips and advice to improve your docs</td><td><a href="docs-best-practices">docs-best-practices</a></td></tr></tbody></table>

***

### Trending guides

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><h3><i class="fa-arrow-up">:arrow-up:</i> Most popular</h3></td><td><ul><li><a href="editing-and-publishing-documentation/complete-guide-to-publishing-docs-gitbook">The complete guide to publishing documentation in GitBook [updated for 2025]</a></li><li><a href="docs-best-practices/documentation-structure-tips">How to structure technical documentation: best practices</a></li><li><a href="content-organization-and-localization/localize-your-docs-with-variants-in-gitbook">Localize your docs with variants in GitBook</a></li><li><a href="editing-and-publishing-documentation/import-or-migrate-your-content-to-gitbook-with-git-sync">Import or migrate your content to GitBook with Git Sync</a></li><li><a href="editing-and-publishing-documentation/upload-and-embed-a-playable-video-into-your-gitbook-docs">Upload and embed a playable video into your GitBook docs</a></li></ul></td></tr><tr><td><h3><i class="fa-sparkle">:sparkle:</i> Recently added</h3></td><td><ul><li><a href="content-organization-and-localization/localize-your-docs-with-variants-in-gitbook">Localize your docs with variants in GitBook</a></li><li><a href="docs-personalization-and-authentication/how-to-personalize-your-gitbook-site-using-url-parameters-and-adaptive-content">Personalize your GitBook site using URL parameters and adaptive content</a></li><li><a href="docs-analytics/track-advanced-analytics-with-gitbooks-events-aggregation-api">Track advanced analytics with GitBook’s events aggregation API</a></li><li><a href="api-documentation/document-your-api-in-gitbook-in-5-simple-steps">Document your API in 5 simple steps</a></li><li><a href="docs-personalization-and-authentication/setting-up-adaptive-content">Personalize your GitBook site using cookies and adaptive content</a></li></ul></td></tr></tbody></table>