How to customize your site’s configuration

Localize your site’s interface, set AI options, and customize your site’s behavior

GitBook’s Configure tab gives you control over advanced site behavior, user interactions, and integrations with AI tools.

This video and guide will take you through editing your site’s configuration, covering:

• Where to find configuration settings

• Localizing the user interface

• Changing how links behave when clicked

• Enabling page feedback and ratings for Insights

• Configuring AI page actions

• Configuring Git Sync actions

• Adding a privacy policy

• and more!

1

Open the Configure tab

From your Docs site overview, open Customization. Then select Configure.

2

Localize the user interface

Set the default language for GitBook’s built-in UI text.

This updates default interface elements like the search placeholder and button labels.

3

Control external link behavior

Choose how external links should open for readers:

• In the same tab (default)

• In a new tab

4

Enable page ratings

Turn on page ratings if you want lightweight feedback on your docs. Ratings appear directly on pages.

You can review the collected feedback in Insights.

5

Configure page actions

Page actions show at the top of documentation pages. Enable only the actions you want readers to see.

Common options include:

• Launching the GitBook Assistant

• Copying the page

• Viewing the page source

• Copying content as Markdown

• Opening the page in external AI tools (like ChatGPT or Claude)

• Connecting to the site’s auto-generated MCP server

• Exporting pages as PDF

6

Enable ‘Edit on Git’ (optional)

If Git Sync is enabled, you can add an Edit on Git action. This lets readers (and your team) jump to your Git repo to propose changes in Markdown.

If you haven’t set it up yet, start with Git Sync.

7

Add a privacy policy

Add a Privacy Policy URL to display it on relevant pages.

This also enables a cookie consent banner in the lower-right corner of your site.

8

Save and publish

Review your configuration changes, then click Save to make them live.

Make sure you hit Save before you navigate away from the Customization screen. Your changes won’t appear on your docs site until you save them.

Related documentation

Customize your docs site

Insights

Markdown formatting

Git Sync

Change requests