Advanced Settings

AI Tools

Ask before Publishing

To publish safely ensuring all comments have been resolved, you can check the Ask Before Publishing setting. To do that:

Open Project Settings → Advanced.
Check Ask before publishing.
Click Save changes in the top menu.

Lock Page when Editing

To ensure only one user is editing the page at a time, you can check the Lock Page when Editing setting. To do that:

Open Project Settings → Advanced.
Check Lock page when editing.
Click Save changes in the top menu.

When this setting is enabled and a user is editing, all other users will see a banner informing them that the page is locked. While this banner is showing, they will not be able to modify the page until the editing user saves or discards. Once the page gets unlocked, the page will refresh automatically.

Require Annotating on Saving

Force editors to annotate the changes to be saved. This helps you keep a clean history. To do that:

Open Project Settings → Advanced.
Check Require annotating on saving.
Click Save changes in the top menu.

Docs Digest Email

The docs digest is a recurring email to the project's admins and publishers covering what needs your attention: broken links, searches that came back with nothing, and the feedback readers left. It also lists pages edited recently but still unpublished, and comments nobody has resolved.

Each section carries a button that opens AI Agent with the request already written, so repairing the links or drafting the missing pages starts from the email itself. Nothing in your documentation changes until you send it and approve what comes back.

To choose how often it arrives:

Open Project Settings → Advanced.
Under Notifications, set Docs digest email to Weekly, Every two weeks, Monthly or Never.
Click Save changes in the top menu.

A project with nothing to report is left out.

Other Settings

⭐

Available in Pro Projects

For advanced settings that we do not provide through the UI, they can modified through Custom HEAD Tags.

The available settings are (with their defaults):

{ warnings: { oldVersion: false // false|true: Show a banner when viewing an older version }, index: { categoryToggle: false // false|true: Set true to disable automatic category toggling on changing page }, search: { scope: "version", // "version"|"section": Set the scope of the search bar hideAiSearch: false // false|true: Hides AI search but keeps the vector search available through API }, tableOfContents: { hideH3: false, // false|true: Hides H3 from table of contents hideH4: false, // false|true: Hides H4 from table of contents. Has no effect if hideH3 is enabled. highlightActive: true // false|true: Highlights last scrolled to heading in table of contents }, code: { theme: "github-dark", // DEPRECATED - Use darkTheme and lightTheme darkTheme: 'github-dark', // Any theme from https://codemirror.net/demo/theme.html (must import CSS as well): Sets the dark theme for code blocks lightTheme: 'github-light', // Any theme from https://codemirror.net/demo/theme.html (must import CSS as well): Sets the light theme for code blocks githubTheme: "github", // Any theme from https://emgithub.com/: Sets the theme for GitHub Code blocks showLineNumbers: false // false|true: Shows a gutter with line numbers in code blocks }, seo: { titleFormats: { // Modifies the browser tab title + META title. Use %page%, %section%, %version% and %project% as placeholders. page: '%page% - %project%', documentation: '%section% - %project%', reference: '%section% - %project%', landingPage: '%project%', customPage: '%section%', '404': '404 - %project%' }, }, apiReference: { collapsedMaxHeight: 1024, // Height which if exceeded the expand button shows for tables/examples lineWrapCode: false, // false|true: Wrap lines in code blocks (request, response, playground) setExampleAsValue: false // false|true: For API playground, sets the example as value }, feedback: { disable: false // Disables feedback control in runtime } }

Applying Settings

To change a setting, use the apply function on window.settings:

Last updated on Aug 24, 2026

Anything missing? Leave us feedback