GitBook

What is GitBook?

GitBook is a documentation platform whose stated goal is to keep docs accurate for both people and AI. Teams write in a block-based editor or in a Git repository, publish docs sites, and add AI features on two sides: GitBook Agent helps writers draft, import, translate and review content, while the AI Assistant answers readers' questions from the published docs.

The company behind it is GitBook Inc, incorporated in the U.S., with a French subsidiary, GitBook SAS.

Three facts shape most buying decisions. Pricing is charged per published site plus per organization member, so costs grow with both the number of sites and the size of the editing team. The reader-facing AI chat, AI insights and Slack/Linear/GitHub channels sit on the Ultimate plan rather than Premium. And GitBook does not offer refunds; a cancelled plan stays active until the end of the billing period and then does not renew.

Core features

GitBook combines a visual editor with docs-as-code workflows, then layers AI on top of the same content. The writing side and the reading side share one source: what the Agent edits is what the Assistant later quotes, and the insights from reader questions feed back into what gets written next.

• Git Sync (docs-as-code): Git Sync is bi-directional, so edits made in the GitBook editor and commits pushed to GitHub or GitLab are both synchronized automatically.
• Stale content detection: GitBook scans docs for content that no longer matches the product and flags it for review, instead of waiting for readers to report outdated pages.
• GitBook Agent for imports: You can attach PDFs and Microsoft Word documents in the GitBook Agent chat sidebar, and the Agent extracts and formats the content into pages.
• GitBook Agent as a reviewer: Added as a reviewer on a change request, GitBook Agent can act as a docs linter, flag style guide issues and suggest or fix errors.
• AI Assistant for readers: The Assistant answers from the docs site and from sources connected to it, and shows readers an expandable list of the sources behind each answer plus related follow-up questions.
• Interactive API playground: Interactive API playgrounds let readers test API endpoints directly inside the docs, and they are included on every plan, including Free.
• Adaptive content: On Ultimate, adaptive content shows or hides content for specific users based on criteria the team defines, with segment limitations applying.

The Agent and the Assistant are separate products with separate plan rules. The Agent works on the editing side and has a free weekly allowance; the full Assistant chat is an Ultimate feature, with a lighter AI search answer box on Premium. The Pricing section below lists where each one sits.

Guide

Moving existing docs into GitBook

1. Open the Import panel when creating a section, then either paste the URL of an existing online docs site or upload Markdown, HTML or Microsoft Word (.docx) files. GitBook applies AI cleanup to imported content by default, and this can be switched off in the menu.
2. Keep each upload within the import caps. A single import is limited to 20 pages and 20 files, GitBook cannot raise these limits, and larger migrations go through Git Sync, which supports up to 5,000 Markdown pages.
3. For repository-based docs, connect GitHub or GitLab through Git Sync. Only administrators and creators can enable and configure Git Sync, so other members need one of those roles to set it up.

Adding a translated version

1. An organization admin opens Translations from the organization Home sidebar and clicks Create translation, choosing a source section and target language. Only organization admins can create and access translations because the feature is billable.
2. Add the finished translation to the published site as a variant, which lets readers switch languages from a toggle in the upper right corner of the docs site.

GitBook use cases and examples

• Gated product or internal docs: Authenticated access is aimed at sensitive product documentation for paying customers, sales prospects or partners, and at internal knowledge base content limited to a company's employees.
• Product hubs and developer portals: Ultimate's sections and groups consolidate several products' docs into one site, described as suited to product hubs, developer portals and help centers.
• Mixed engineering and writing teams: Developers can commit directly from GitHub or GitLab while technical writers, instructional designers and product managers edit and discuss the same changes inside GitBook.
• Finding documentation gaps: AI insights show how the Assistant answered users' questions, so teams can identify the knowledge gaps to fill.

Most of these cases depend on features above the Free plan. Git Sync and a public docs site on a GitBook-hosted address work on Free with one user; gated audiences, multi-product sites and reader AI analytics require Ultimate.

Who is it for

GitBook's own plan descriptions map to four audiences: Free is aimed at individuals, Premium at public branded docs sites, Ultimate at centralized docs with AI, and Enterprise at global teams scaling their docs.

• Individuals and solo maintainers: Individual students keeping personal and course notes are pointed to the Free plan, which provides unlimited private content at no cost.
• Software teams with docs in Git: Teams that want writers and engineers working on the same Markdown files get bi-directional GitHub or GitLab sync on every plan, including Free.
• Eligible non-profits, open source projects and education groups: These can apply for the free Community plan, but the criteria exclude cryptocurrency and gaming projects, and an open source project must not be associated with a for-profit or venture-backed company.
• Less suited: Organizations that need many separate sites or many in-app members pay for each, because the site fee and the member fee are charged independently.

Platforms

GitBook is a hosted service: teams work in the GitBook app and publish docs sites, and most platform choices concern where those sites connect.

• Git hosting: GitHub and GitLab through Git Sync; Git Sync IP allowlisting is available only for Enterprise customers.
• Team chat and issue tools: Channels integrate GitBook Assistant and GitBook Agent into Slack, Linear and GitHub.
• AI tools and agents: Each published page has a Markdown version, and every published site exposes llms.txt, llms-full.txt and an MCP server that compatible AI tools can query.
• Embedding: The Assistant can be embedded into your own website or product, and in published docs it sits in the sidebar on Ultimate or in the search box on Premium and Ultimate.
• Sign-in providers: Authenticated access uses integrations for Okta, Azure and Auth0, or a custom authentication server that the customer hosts, codes and maintains.

Pricing

GitBook pricing combines a per-site plan fee with a per-user fee for organization members.

The pricing page lists Premium from $65 per site/month and Ultimate at $249 per site/month when billed annually, with extra users at $12 per user/month. It also states that all amounts shown are monthly costs under annual billing and labels the annual option as two months free, without displaying a monthly-billed list price. The billing policy page, however, lists Premium at $65 per site per month plus $12 per member and uses those same rates in a monthly-billing proration example, so the two official pages describe the monthly rate differently.

• Traffic: GitBook does not limit traffic to published documentation, and page views are listed as unlimited.
• Free tier scope: The $0 Basic site plan includes one user. Basic sites are unlimited and free, but custom domains, advanced customization and other premium features require upgrading that site to a paid plan.
• AI by plan: AI Search is available on Premium and Ultimate, while GitBook Assistant, AI insights and channels remain Ultimate-only.
• Assistant allowance: The comparison table lists the AI Assistant with 500 successful answers included, marked as a soft limit, with a contact option beyond that and custom tiers available.
• Add-on billing: Add-ons such as the Advanced AI Assistant and Translations include a monthly allowance; going over keeps the feature running and the extra usage is billed on the next invoice, at the end of the billing period.
• Translations add-on: Translations cost $25 per month or $250 per year for up to 50,000 translated words each month, plus $0.20 per additional 1,000 words, and the word allowance resets at the start of each month.
• GitBook Agent: The Agent help page describes it as free for all plans while in beta, with free usage of 10 messages per week for accounts that are not on Pro and not on a trial.
• Trial: Premium and Ultimate show a 14-day free trial. The trial starts when a site is published to an audience or additional members are invited, needs no payment method, and unlocks every Ultimate feature for testing.
• Members: Organization members cost the same regardless of permissions, so guests and readers inside the app are billed like editors.
• Upgrade prompts: Plan upgrades require confirmation in a modal that shows plan details and pricing, and publishing a site with Premium or Ultimate features or adding a custom domain or advanced customization can trigger that prompt.
• Annual true-ups: On annual billing, increases during the term are billed through an annual true-up that can arrive on a separate invoice before renewal.
• Refunds and discounts: GitBook does not offer refunds, and unused fees are credited to the account for future use. Apart from two months free on annual plans and the free Community plan, no other discounts are offered at this time.
• Payment methods: Payment by invoice is available on Enterprise; other plans pay by credit card or the localized payment methods available in the buyer's region.
• Community plan: The Community plan is free for eligible non-profits, open source organizations and education-related groups, and includes all Ultimate features except SAML SSO.

GitBook alternatives

GitBook alternatives fall into two groups: other hosted docs platforms, and the general-purpose wikis that teams often migrate from.

• Mintlify: Mintlify's Starter tier is aimed at individuals and small teams and lists 5 editor seats, a custom domain, authentication, an MCP server and an API playground, with the company saying users can get started for free. Its paid tier for startups and growing teams lists unlimited editor seats, an Agent and an Assistant.
• Existing wikis and docs tools: GitBook supports imports from Confluence, Notion, GitHub Wiki, Quip, Dropbox Paper and Google Docs, so teams leaving those tools have a direct migration path.

The main trade-off is the pricing unit. GitBook charges per site and per member and keeps reader AI chat on Ultimate, while Mintlify's tiers are organized around editor seats and bundle the Assistant into its paid tier. Teams with one docs site and a small writing group feel this difference less than teams running several sites.

Limitations

Product limits

• Assistant scope: The Assistant does not answer across published sections that live on different docs sites; multi-section search only works within one site.
• Translation costs can spike: Changing the translation glossary triggers a full re-translation, and a small edit to a large page re-translates and bills the entire page.
• AI search lag: Content changes can take up to one hour to appear in AI search results.
• Lapsed billing locks teams out: An ended trial, failed payment or lapsed subscription can restrict collaboration immediately, removing members' access while the primary administrator keeps access.
• Mixed outside reviews: As captured on October 5, 2026, GitBook's company profile on a third-party review platform showed a 3.8 score from 23 reviews, 52% of them one-star, with a notice that the reviews may not be representative because the company has not invited customers recently.

Privacy and data

• AI model training: GitBook Agent does not use customer data to train AI models, and the information added to it is shared with OpenAI only to provide the Agent.
• AI search processing: GitBook AI passes content to OpenAI to index and process it, and GitBook states that OpenAI does not use this content for service improvements, including model training.
• Reader questions: The AI Assistant help page does not state whether reader questions are used for model training.
• Hosting and encryption: Customer data is stored in U.S. data centers on Google Cloud and encrypted at rest and in transit, while some HTML pages and assets may be cached in other regions by the CDN.
• Certifications: GitBook says it is SOC 2, ISO 27001 and GDPR compliant and offers SAML-based SSO.
• Sign-up data: Signing up requires only an email address, but a phone number may be required for new users depending on a risk evaluation of the email address and IP address.
• Account retention: GitBook does not automatically delete inactive accounts, and after a deletion request it says it will delete the full profile within 90 days, barring legal requirements.
• Hidden is not private: Hidden pages are still included in llms-full.txt and remain available through the site's MCP server, because hiding only removes a page from the published table of contents.

FAQ

Q1. Do I need a credit card to try GitBook's paid features?

No. The 14-day trial starts when you publish a site to an audience or invite more members, and it does not require a payment method. At the end you choose a plan or downgrade to free.

Q2. Can I get a refund on a GitBook subscription?

GitBook does not offer refunds. Unused fees are credited to the account for future use, and GitBook directs suspected billing errors to its support team.

Q3. Does GitBook use my documentation to train AI models?

GitBook states that GitBook Agent does not use your data to train AI models and shares it with OpenAI only to provide the Agent. For AI search, content is passed to OpenAI, which GitBook says does not use it for model training. The AI Assistant help page does not address training use of reader questions.

Q4. Can open source projects use GitBook for free?

Eligible open source projects can apply for the free Community plan, which includes all Ultimate features except SAML SSO. Projects tied to a for-profit or venture-backed company do not qualify.