Documentation is often the first thing prospective customers find when they search for your product. Doxbrix gives you controls to make your docs rank well, rend...
Documentation is often the first thing prospective customers find when they search for your product. Doxbrix gives you controls to make your docs rank well, rend...
Documentation is often the first thing prospective customers find when they search for your product. Doxbrix gives you controls to make your docs rank well, render rich previews when shared, and lay out the site the way you want — with strong defaults so most pages need no manual SEO work.
These controls live in two settings sections: SEO & Social and Publishing Controls, plus Site Layout — all under Settings → Project (/settings/project).
Page metadata
Every page's core metadata comes from its frontmatter:
---
title: Authenticate API requests
description: Pass your API key as a bearer token to authenticate every request.
---titlefeeds the browser tab and the search-result heading.descriptionfeeds the search-result snippet and AI search. Keep it to ~100–160 characters.
SEO & Social settings
The SEO & Social section sets site-wide search and sharing defaults:
| Setting | What it controls |
|---|---|
| **Meta title template** | A pattern for the `<title>` of every page (e.g. `%page% — Acme Docs`). |
| **Fallback meta description** | The description used when a page has none. |
| **OG image** | The default social-sharing preview image (`og:image`). |
| **Locale alternates** | Declares language alternates so search engines connect your [localized](/organize/multi-language) versions. |
| **Search engine hints** | Additional hints for how engines should treat your content. |
Indexing and robots
The Publishing Controls section governs how search engines crawl your site:
| Setting | Options |
|---|---|
| **Robots rule** | **Index everything**, **Noindex drafts**, or **Noindex entire site**. |
| **Indexing policy** | **Workspace default**, **Allow indexing**, or **Discourage indexing**. |
| **Sitemap generation** | Generate and maintain a `sitemap.xml` automatically. |
| **Canonical URL** | The canonical base URL, to avoid duplicate-content issues. |
| **Preview URL** | The base path used for [preview](/cli/preview/link) links. |
Unpublished page handling
Also in Publishing Controls, Unpublished page handling decides what happens when a reader reaches a page that isn't published:
| Option | Behavior |
|---|---|
| **Hide from navigation** | The page is absent from the sidebar and not reachable. |
| **Show teaser** | A teaser/placeholder is shown instead of the content. |
| **Redirect to home** | The reader is redirected to the site home. |
Site Layout
The Site Layout section chooses how your whole published site is structured:
| Layout | Description | Good for |
|---|---|---|
| **Documentation (sidebar)** | A classic sidebar-driven docs site. | Product docs, API references, guides |
| **Help Center (categories)** | A category-driven landing page. | Customer help centers, support sites |
See Reader experience → Published site for how each looks to readers.