Skip to main content
After you add a custom domain like docs.example.com, your default <subdomain>.mintlify.app address stays publicly reachable and search engines can continue to crawl it. In some cases the default address outranks your custom domain in search results.

​
Why this happens

Mintlify does not automatically disable, redirect, or apply noindex to your default address when you add a custom domain. Some setups depend on the default address to serve the custom domain, so turning it off would take those sites down. Pages on your default address already set their canonical URL to your custom domain, but the canonical tag is a hint that search engines can ignore. This is more likely when the default address has more inbound links or a longer indexing history than your custom domain.

​
Speed up removal from search results

  • If you set a canonical URL in seo.metatags.canonical in your docs.json or in a page’s frontmatter, make sure it uses your custom domain. See Set a canonical URL.
  • In Google Search Console, add your custom domain as a property and submit its sitemap at https://<your-custom-domain>/sitemap.xml.
  • To hide default address URLs from Google results sooner, add <subdomain>.mintlify.app as a Search Console property and use the Removals tool. Verify the property with a google-site-verification meta tag.