Host it at your own /help
Serve the help center at https://example.com/help on your main site, with one rewrite.
A help center on your own domain is better for search: its pages build up your site's standing,
not the install's. Your site passes every request under /help on to the install, and the
install renders the pages with your site's address in their links, canonical addresses and
sitemap.
Before you start
- A site whose server or host can rewrite a path to another address, such as Next.js, Vercel, Netlify, Cloudflare or nginx.
- An admin account on your install.
Set it up
-
Add a rewrite of
/help/:path*to your install's/help/:path*. In Next.js:next.config.js module.exports = { async rewrites() { return [{ source: "/help/:path*", destination: "https://support.example.com/help/:path*" }]; }, }; -
In Settings → Branding → Help center → Search engines, set Public address to
https://example.com/help. -
Open
https://example.com/help. Links between pages, canonical addresses andhttps://example.com/help/sitemap.xmlnow use your site's address.
The one rule is enough: everything a help page loads from the install is under /help too. Its
scripts and styles are under /help/_assets and collection icons under /help/_icons. Search
and the chat still talk to the install's own address, which the pages allow.
Note
Submit https://example.com/help/sitemap.xml to search engines, not the install's, once the
public address is set.