Embed in your product

Embed your documentation in your product or website using the Docs Embed.

The Docs Embed is a powerful window into your product knowledge that you can add to any product or website. Users can ask questions to the GitBook Assistant, search your docs, or browse pages directly, without leaving your product. You can open the embed with a button, put it in any component you want, or control it completely programmatically.

Embed your docs into your product or website

Overview

The Docs Embed can contain three tabs:

• Assistant: The GitBook Assistant - an AI-powered chat interface to help users find answers

• Search: A search-focused surface for quickly finding pages and asking scoped questions

• Docs: A browser for navigating your documentation site

All tabs are enabled by default. If you set tabs, the embed shows only the tabs you list.

You can customize and override the default configuration with custom actions, tools, suggested questions, Authenticated Access, and more.

Get started

1

Prerequisites

Before embedding your docs, ensure:

1. Your docs are published and accessible at a URL (e.g., https://docs.company.com).

2. You have retrieved the embed script URL from your site settings (Settings → AI & MCP → Embed).

If you want to use the Assistant tab, GitBook Assistant must be enabled for your docs site (Settings → AI & MCP).

2

Implementation

Use our skill to quickly implement GitBook Assistant into your product using your existing stack.

10KB

GITBOOK_ASSISTANT_SKILL.md

Open

Alternatively, continue reading through the docs for the approach that matches your setup:

Standalone script tag

Drop in a <script> tag for the fastest setup, then customize its appearance

Node.js/NPM

Install via NPM for server-side rendering or build-time control

React component

Use prebuilt React components for seamless integration

If your docs use Authenticated Access, follow the steps in how to set up the embed with authenticated docs.

3

Configuration

• Customizing the Embed – Add welcome messages, custom actions, and suggestions

• Creating custom tools – Connect Assistant to your product APIs

Further reading

For the complete API reference and source code, see the @gitbook/embed package on GitHub.