# 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](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/publishing-documentation/customization/extra-configuration)
* [Localizing the user interface](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/publishing-documentation/customization/extra-configuration#localize-user-interface)
* Changing how links behave when clicked
* Enabling page feedback and ratings for [Insights](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/publishing-documentation/insights)
* [Configuring AI page](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/publishing-documentation/customization/extra-configuration#open-in-ai-providers) actions
* [Configuring Git Sync](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/publishing-documentation/customization/extra-configuration#edit-on-github-gitlab) actions
* [Adding a privacy policy](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/publishing-documentation/customization/extra-configuration#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**](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/publishing-documentation/customization). 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**](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/publishing-documentation/insights).
{% 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**](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/creating-content/formatting/markdown)
* Opening the page in external AI tools (like ChatGPT or Claude)
* Connecting to the site’s [**auto-generated MCP server**](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/publishing-documentation/mcp-servers-for-published-docs)
* 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](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/getting-started/git-sync).
{% 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="https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/publishing-documentation/customization">Site customization</a></td></tr><tr><td><strong>Insights</strong></td><td><a href="https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/publishing-documentation/insights">Site analytics</a></td></tr><tr><td><strong>Markdown formatting</strong></td><td><a href="https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/creating-content/formatting/markdown">Markdown</a></td></tr><tr><td><strong>Git Sync</strong></td><td><a href="https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/getting-started/git-sync">GitHub &#x26; GitLab Sync</a></td></tr><tr><td><strong>Change requests</strong></td><td><a href="https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/collaboration/change-requests">Change requests</a></td></tr></tbody></table>