--- title: Configuration description: Configure your documentation with a docs.json file. --- Add a `docs.json` file to the root of your GitHub repository to configure your documentation. Below is a list of all available configuration options, which can be used to modify the logos, theme, analytics and more. If your IDE supports JSON Schemas, you can add a `$schema` property to your `docs.json` file to enable autocompletion and validation: ```json title="docs.json" { "$schema": "https://docs.page/schema.json" } ``` ## Properties ### Top-level properties The name of your project. This will be displayed in the header of your documentation and used for other aspects such as automatic social preview images. --- A short description of your project. This will be used in meta tags and social preview images. --- Defines the favicon to show in the browser tab. See [Asset URLs](/assets) for more information on how to add assets to your documentation. The favicon can either be a `string` value which will be used for both light and dark modes, or a `Favicon` object to define separate favicons for light and dark modes. The Asset URL of your favicon to display when the documentation is in light mode. --- The Asset URL of your favicon to display when the documentation is in dark mode. --- An asset URL to use as the default social preview image for your documentation. If not provided, a social preview image will be automatically generated. Individual pages can override this social preview URL by specifying a [`socialPreview` property](/writing-content#frontmatter) in their frontmatter. See [Asset URLs](/assets) for more information on how to add assets to your documentation. --- ### Logo Configures the logo of your documentation, which will be displayed in the header and used for social preview images. The minimum height of the logo should be 24px. Note that if only a light or dark logo is provided, it will be used for both light and dark modes. See [Asset URLs](/assets) for more information on how to add assets to your documentation. The Asset URL of your logo to display when the documentation is in light mode. --- The Asset URL of your logo to display when the documentation is in dark mode. ### Theme Configures the theme of your documentation. If not provided, a default theme will be used. The default theme of your documentation. This will be used when the user has not manually selected a theme. --- A hex color code to use as the primary color of your documentation. This color will be used for links, buttons, and other interactive elements. --- A hex color code to use as the primary color of your documentation in light mode. If not specified, the `primary` color will be used. --- A hex color code to use as the primary color of your documentation in dark mode. If not specified, the `primary` color will be used. --- A hex color code to use as the background color of your documentation in light mode. --- A hex color code to use as the background color of your documentation in dark mode. ### Header Configures the header of your documentation. Whether to show the documentation `name` next to the logo in the header. Defaults to `true`. --- Whether to show the theme toggle button in the header. Defaults to `true`. --- Whether to show the GitHub card in the header. Defaults to `true`. --- An array of `Link` objects to display in the header of your documentation. The URL to link to. --- The text to display for the link. --- Whether to display the link as a call-to-action button. Defaults to `false`. --- If provided, only show this link when viewing the documentation for a specific [locale](/locales). ### Anchors Configures the anchor links of your documentation. The title of the anchor link. --- The URL to link to. --- The [icon](/components/icons) to display next to the anchor link. --- If provided, only show this anchor when viewing the documentation for a specific [locale](/locales). --- If provided, only show this anchor when viewing a specific [tab](/navigation#tabs). ### Social Links An object of key value pairs where the key is the social platform and the value is the username/ID to link to: ``` { "social": { "x": "@invertaseio", "github": "invertase" } } ``` A generic website URL to link to, such as your homepage or product. --- The name of your X/Twitter account, e.g. `@invertaseio`. --- The name of your YouTube account. --- The name of your Facebook account. --- The name of your Instagram account. --- The name of your LinkedIn account. --- The name of your GitHub account. --- The subdomain of your Slack organization. --- The name of your Discord organization. ### SEO Configures the SEO settings of your documentation. Whether to instruct search engines not to index your documentation. Defaults to `false`. ### Variables An object of common variables which can be replaced in your documentation content using the `{{ variableName }}` syntax. For example, the following: ```json { "variables": { "versions": { "default": "1.0.0", } } } ``` Can be replaced via the `{{ versions.default }}` syntax in your documentation content. ### Search Configures the search settings of your documentation. Whether to enable search via Algolia DocSearch in your documentation. See [Search](/search) for more information on how to configure DocSearch. The DocSearch application ID for your documentation. --- The DocSearch API key for your documentation. --- The DocSearch index name for your documentation. ### Scripts Configures the scripts to include in your documentation. The Google Tag Manager ID to include in your documentation. --- The Google Analytics ID to include in your documentation. --- If provided and your documentation uses a [Custom Domain](/custom-domains), the [Plausible Analytics](https://plausible.io/) domain to include in your documentation. If set to `true`, the default Plausible Analytics script (`https://plausible.io/js/plausible.js`) will be used. Provide a string to use a custom self hosted Plausible Analytics script. ### Content Configures how the content of your documentation is displayed. The maximum heading depth to display in the table of contents. Defaults to `3`. --- Whether to enable image zooming by default for all images in your documentation. Defaults to `false`. See the [``](/components/images) component for more information on how to enable image zooming for specific images. --- Whether to automatically infer the next and previous page links based on your sidebar navigation. Defaults to `true`. --- Whether to automatically show the page title from frontmatter at the top of each page. Defaults to `true`. --- Whether to automatically show the page social image from frontmatter at the top of each page. Defaults to `true`. ### Tabs An array of `Tab` objects to display at the top of your documentation. See [Navigation](/navigation#tabs) for more information on how to configure tabs. The unique ID of the tab. --- The title of the tab to display. --- The URL to link to when the tab is clicked. --- If provided, only show this tab when viewing the documentation for a specific [locale](/locales). ### Sidebar An array or object of `Sidebar` objects to display in the sidebar of your documentation. See [Navigation](/navigation#sidebar) for more information on how to configure the sidebar. The page links to display in the sidebar. The title of the sidebar item. --- The URL to link to when the sidebar item is clicked. --- The [icon](/components/icons) to display next to the sidebar item. --- The group title to display the sidebar item in. If not provided, the sidebar item will be displayed at the top level. --- The URL to link to when the sidebar item is clicked. --- The [icon](/components/icons) to display next to the sidebar item. --- If provided, only show this sidebar item when viewing a specific [tab](/navigation#tabs).