SEO Settings
The SEO settings area in Hyperdocs has two parts: a global SEO panel where you configure site-wide metadata, scripts, and search-engine directives, and a separate AI & Agents tab where you control how your documentation is exposed to AI tools and crawlers. Both live under Marketing in the admin sidebar.
Global SEO Panel
The global SEO panel sets defaults that apply across your entire published site. Open it from Marketing → SEO in the admin sidebar. Changes take effect on your live site after you click Save.
Open Graph Image
The Open Graph Image is the preview image shown when a link to your docs is shared on social platforms or in messaging apps. Upload a custom image by clicking the upload area, or remove the current one with the remove button. If no image is uploaded, the default Hyperdocs favicon is used as the fallback.
Meta Title
The Meta Title field sets the default page title used for pages that do not define their own — for example, the Help Center. If left empty, it falls back to your organization name set in General Settings.
Meta Description
The Meta Description field sets the default description used for pages that do not define their own. If left empty, it falls back to a dash (`-`). Individual documentation pages can override this with their own per-page meta description.
Head Scripts
The Head Scripts field accepts raw HTML injected into the `<head>` of every public page — useful for verification tags, analytics snippets, or other scripts that must load early. Every `<script>` tag must have a matching closing `</script>` tag, and all HTML tags must be properly closed. An inline validation error appears if the markup is malformed, and the save is blocked until it is corrected.
Body Scripts
The Body Scripts field accepts raw HTML injected into the `<body>` of every public page — suitable for chat widgets, tracking pixels, or other scripts that do not need to be in the head. The same tag-balance validation applies.
Custom CSS
The Custom CSS field accepts raw CSS rules applied to your published site. Do not include `<style>` or `<script>` tags — paste only the CSS rules themselves. Unbalanced braces are caught by inline validation before the save goes through.
Custom robots.txt
The Custom robots.txt field lets you override the default robots directives for your documentation site. Enter standard robots.txt syntax to control how search engine crawlers index your content.
Saving your changes
Click Save at the bottom of the panel to apply all changes. The Save button is only active when you have made a change to at least one field. After saving, the public site is updated immediately.