Skip to content

Set canonical domain in docs.json once the help center's custom domain is live #2

Description

@samagra14

What

Once the help center gets its custom domain (e.g. help.whip.run), add the global canonical metatag to docs.json:

"seo": {
  "indexing": "all",
  "metatags": {
    "canonical": "https://help.whip.run"
  }
}

Mintlify appends each page's path to this base automatically.

Why

Per Mintlify's SEO docs, a global canonical consolidates ranking signals when the docs are reachable from more than one host (the default *.mintlify.app subdomain + the custom domain). Right now Mintlify auto-generates per-page canonicals from the serving URL, which is correct behavior until the custom domain exists — setting it early to a domain that isn't live yet would hurt indexing rather than help.

When

Blocked on: custom domain being configured in the Mintlify dashboard.

Also noted in AGENTS.md → "SEO maintenance" so it doesn't get lost.

🤖 Generated with Claude Code

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions