Passer au contenu principal
Après avoir ajouté un domaine personnalisé comme docs.example.com, votre adresse par défaut <subdomain>.mintlify.app reste accessible publiquement et les moteurs de recherche peuvent continuer à l’explorer. Dans certains cas, l’adresse par défaut est mieux classée que votre domaine personnalisé dans les résultats de recherche.

Pourquoi cela se produit

Mintlify ne désactive pas, ne redirige pas et n’applique pas noindex automatiquement à votre adresse par défaut lorsque vous ajoutez un domaine personnalisé. Certaines configurations dépendent de l’adresse par défaut pour servir le domaine personnalisé, donc la désactiver mettrait ces sites hors ligne. Les pages de votre adresse par défaut définissent déjà leur URL canonique sur votre domaine personnalisé, mais la balise canonical est une indication que les moteurs de recherche peuvent ignorer. C’est plus probable lorsque l’adresse par défaut a plus de liens entrants ou un historique d’indexation plus long que votre domaine personnalisé.

Désactiver l’adresse par défaut

Le support peut faire en sorte que votre adresse par défaut <subdomain>.mintlify.app renvoie une erreur 404 afin que les moteurs de recherche la retirent de leur index. Votre domaine personnalisé continue de fonctionner. Cette option n’est disponible que si le CNAME de votre domaine personnalisé pointe vers cname.mintlify.builders, comme indiqué sur la page de configuration du domaine personnalisé. Si votre CNAME pointe vers votre adresse <subdomain>.mintlify.app, ou si vous servez votre documentation via un proxy inverse, la désactivation de l’adresse par défaut met également votre domaine personnalisé hors ligne. Pour désactiver l’adresse par défaut, envoyez un e-mail à support@mintlify.com depuis une adresse e-mail associée à votre organisation. Indiquez :
  • Votre domaine personnalisé, comme docs.example.com.
  • Votre adresse par défaut, comme acme.mintlify.app.
  • L’organisation et le projet, au format app.mintlify.com/<your-org>/<your-project>.
Tant que l’adresse par défaut est désactivée, vous ne pouvez pas ajouter de nouveau domaine personnalisé depuis le dashboard. Contactez le support si vous devez changer de domaine ultérieurement.

Accélérer la suppression des résultats de recherche

  • Si vous définissez une URL canonique dans seo.metatags.canonical dans votre docs.json ou dans le frontmatter d’une page, assurez-vous qu’elle utilise votre domaine personnalisé. Consultez Définir une URL canonique.
  • Dans Google Search Console, ajoutez votre domaine personnalisé en tant que propriété et soumettez son sitemap à l’adresse https://<your-custom-domain>/sitemap.xml.
  • Pour masquer plus rapidement les URL de l’adresse par défaut dans les résultats Google, ajoutez <subdomain>.mintlify.app en tant que propriété Search Console et utilisez l’outil Suppressions. Validez la propriété avec une balise meta google-site-verification avant que le support ne désactive l’adresse par défaut, car la validation nécessite que l’adresse soit accessible.