Customization

The look of your site is driven by docs.json plus the MDX components you use. Most teams need only a handful of changes to feel "theirs."

Site name and navigation

docs.json is the source of truth:

{
  "name": "Acme Docs",
  "navigation": [
    { "group": "Getting Started", "pages": ["introduction", "quickstart"] }
  ]
}

Reorder groups, rename them, or add new pages — pages are referenced by their slug (the file path without the .mdx extension).

Redirects

Old URLs you want to keep working? Add redirects:

"redirects": [
  { "from": "/old-quickstart", "to": "/quickstart" }
]

What's in MDX

Every page is MDX, which means you can use markdown freely AND embed React components. Skim the Components section for examples of callouts, tabs, and code blocks you can drop into any page.