Skip to main content

Configuration

docStatic site configuration is managed through the docusaurus.config.ts file. For information about editing this file directly, refer to Configuration in the Docusaurus documentation.

To use the CMS to edit the configuration, navigate to the Settings collection. From here, you can configure the site's:

  • Title.
  • Tagline.
  • Favicon.
  • GraphQL Schema URL.
  • Default Colour Mode (dark or light).
  • Footer items.
  • Languages.
  • Logo.
  • OpenAPI schemas.
  • Syntax Highlighting.
  • URL.
  • Navbar.
  • Sidebar settings.
  • Blog settings.

There is a separate Theme collection for changing the colour scheme and typography settings.

Site vs. Collections

The CMS sidebar splits into two groups:

  • Collections—repeatable content you create many documents from, such as Blog Articles, Docs, Pages, Glossary Terms and Wiki Pages.
  • Site—singleton, site-wide configuration that only ever has one document: Settings, Theme, Home Page, Chatbot, Dashboards, Table of Contents and the built-in Media Manager.

A collection appears under Site rather than Collections when its schema sets ui.global: true. This also changes how it's edited: it opens directly from the sidebar instead of through a document list.

Related topics