# How to customize your site’s configuration

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](/docs/docs-site/customization/extra-configuration.md)
* [Localizing the user interface](/docs/docs-site/customization/extra-configuration.md#localize-user-interface)
* Changing how links behave when clicked
* Enabling page feedback and ratings for [Insights](/docs/docs-site/insights.md)
* [Configuring AI page](/docs/docs-site/customization/extra-configuration.md#open-in-ai-providers) actions
* [Configuring Git Sync](/docs/docs-site/customization/extra-configuration.md#edit-on-github-gitlab) actions
* [Adding a privacy policy](/docs/docs-site/customization/extra-configuration.md#privacy-policy)
* and more!

{% embed url="<https://www.youtube.com/watch?v=V4MQQzUnxwY>" %}

{% stepper %}
{% step %}

### Open the Configure tab

From your **Docs site overview**, open [**Customization**](/docs/docs-site/customization.md). Then select **Configure**.
{% endstep %}

{% step %}

### 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.
{% endstep %}

{% step %}

### Control external link behavior

Choose how **external links** should open for readers:

* In the same tab (default)
* In a new tab
  {% endstep %}

{% step %}

### 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**](/docs/docs-site/insights.md).
{% endstep %}

{% step %}

### 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**](/docs/creating-content/formatting/markdown.md)
* Opening the page in external AI tools (like ChatGPT or Claude)
* Connecting to the site’s [**auto-generated MCP server**](/docs/ai-and-search/mcp-servers-for-published-docs.md)
* Exporting pages as **PDF**
  {% endstep %}

{% step %}

### 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](/docs/getting-started/git-sync.md).
{% endstep %}

{% step %}

### 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.
{% endstep %}

{% step %}

### Save and publish

Review your configuration changes, then click **Save** to make them live.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
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.
{% endhint %}

### Related documentation

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref">Link</th></tr></thead><tbody><tr><td><strong>Customize your docs site</strong></td><td><a href="/spaces/NkEGS7hzeqa35sMXQZ4X/pages/d9NivHBiVedTIKopEvBl">/spaces/NkEGS7hzeqa35sMXQZ4X/pages/d9NivHBiVedTIKopEvBl</a></td></tr><tr><td><strong>Insights</strong></td><td><a href="/spaces/NkEGS7hzeqa35sMXQZ4X/pages/26Gxb8Al3EJRM41yVVxc">/spaces/NkEGS7hzeqa35sMXQZ4X/pages/26Gxb8Al3EJRM41yVVxc</a></td></tr><tr><td><strong>Markdown formatting</strong></td><td><a href="/spaces/NkEGS7hzeqa35sMXQZ4X/pages/dzIzAdrAGag06beRqJn7">/spaces/NkEGS7hzeqa35sMXQZ4X/pages/dzIzAdrAGag06beRqJn7</a></td></tr><tr><td><strong>Git Sync</strong></td><td><a href="/spaces/NkEGS7hzeqa35sMXQZ4X/pages/HzpkoWwYu6eCKccs3i93">/spaces/NkEGS7hzeqa35sMXQZ4X/pages/HzpkoWwYu6eCKccs3i93</a></td></tr><tr><td><strong>Change requests</strong></td><td><a href="/spaces/NkEGS7hzeqa35sMXQZ4X/pages/63708FEvI5p290523NgW">/spaces/NkEGS7hzeqa35sMXQZ4X/pages/63708FEvI5p290523NgW</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gitbook.com/docs/guides/customizing-your-site/how-to-customize-your-sites-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.