Dépannage

Les problèmes que rencontrent réellement les acheteurs, chacun avec sa cause et sa solution.

Mis à jour le 23 août 2026 · 8 min de lecture · S'applique à partir de la version 1.0.0

La plupart des problèmes avec un nouveau theme viennent des quelques éléments qu'un fichier de theme ne peut pas transporter : vos formulaires, votre vidéo, vos menus, le contenu existant de votre blog. Retrouvez votre symptôme ci-dessous.

Blog

La page de liste du blog garde le contenu de l'ancien theme

Symptôme. La page de liste utilise le header, le footer et les styles de Mistral Pro, mais son corps affiche encore les modules du theme précédent.

Cause. Le contenu enregistré d'une page en glisser-déposer appartient à la page, pas au template. Quand vous changez le template de liste, HubSpot conserve le contenu que la page avait déjà — c'est le bon comportement lors d'un changement de theme, mais cela laisse les anciens modules en place. Le blog est correctement lié au template Mistral Pro ; seul le corps est périmé.

Solution. Paramètres → Contenu → Blog → Modèles → Page de liste du blog → Modifier la page. Supprimez les anciens modules et déposez ceux du template, dans cet ordre : Two-tone section heading, Featured blog post banner, Blog posts grid with topic filters and pagination, Newsletter signup band, Dark call to action banner. Choisissez votre formulaire newsletter, définissez le titre, publiez. Autre option : créez un nouveau blog en choisissant les templates de liste et d'article de Mistral Pro à la création, puis déplacez-y vos articles.

Un module de blog affiche un espace réservé ou rien du tout

Cause. Le blog sélectionné n'a aucun article publié, ou le module pointe vers le mauvais blog. « Select a blog » dans le champ Blog signifie « le blog par défaut du compte ».

Solution. Publiez au moins un article, ou choisissez le bon blog dans le groupe Source du module. Pour Posts carrying a given tag, vérifiez les slugs d'étiquettes (séparés par des virgules). Pour le Featured blog post banner pointé vers un article par URL ou slug, augmentez Lookup depth si l'article est plus ancien que les 20 plus récents (valeur par défaut).

La bannière de l'article à la une disparaît en page 2 de la liste

C'est l'option Only on page 1 of the listing, activée par défaut. Désactivez-la dans le groupe Source du module pour afficher la bannière sur toutes les pages.

Formulaires

Le formulaire n'apparaît pas sur la page publiée

Symptôme. L'éditeur de page montre une carte de formulaire vide ; la page publiée affiche les titres et les coordonnées, mais pas de formulaire.

Cause. Les trois modules à formulaire — Contact details with embedded form, Lead capture hero with embedded form, Newsletter signup band — sont livrés sans formulaire sélectionné, parce qu'un identifiant de formulaire appartient à un seul compte.

Solution. Sélectionnez le module, ouvrez l'onglet Contenu et choisissez l'un de vos formulaires dans le champ Form. Pour la page de liste du blog, faites-le depuis Paramètres → Contenu → Blog → Modèles → Page de liste du blog → Modifier la page. Voir Formulaires.

Le formulaire ne ressemble pas au theme

Chaque formulaire intégré suit le groupe Forms des réglages du theme. Si un formulaire a un aspect différent, vérifiez que Mistral Pro est le theme actif (Paramètres → Contenu → Thèmes) et que la page utilise un template Mistral Pro.

Vidéo

La vidéo du hero ne se lance pas

Vérifiez, dans cet ordre :

Aucun fichier sélectionné. Le theme ne contient aucune vidéo. Réglez Background → Looping video et choisissez un MP4 de votre Gestionnaire de fichiers dans Background video (MP4). Voir Vidéo.
Les animations sont coupées. Quand Motion and animations est désactivé dans les réglages du theme, ou que le navigateur du visiteur demande de réduire les animations, le hero affiche volontairement l'image poster à la place de la vidéo.
Le fichier est trop lourd ou n'est pas un MP4. Gardez la vidéo de fond sous 3 Mo environ, en MP4 H.264, muette et sans piste audio (les navigateurs ne lancent automatiquement que les vidéos muettes).
Une image s'affiche à la place. Background est réglé sur Image : la vidéo ne joue qu'en mode Looping video.

La carte showreel est invisible

Sans vidéo de showreel, la carte n'est pas affichée — c'est pourquoi elle est masquée sur une installation neuve. Show showreel card est déjà activé dans le groupe Display (vérifiez que personne ne l'a désactivé) ; ce qui manque, c'est le fichier : ouvrez le groupe Showreel card et renseignez Showreel video (MP4) et un Showreel poster.

Menus, header et footer

Le header recouvre le haut de ma page / le texte est illisible sur un hero clair

Le header est transparent au-dessus d'un hero sombre par défaut (Réglages du theme → Header → Transparent over dark hero sections), et le module hero a Overlap the header activé. Sur une page qui s'ouvre par un bloc clair, gardez le Text tone du hero en texte sombre sur fond uni clair, ou désactivez Overlap the header sur le hero, ou désactivez la transparence globalement dans les réglages du theme.

Menu source du header est par défaut sur Simple menu edited here — le petit menu de démonstration enregistré avec le header. Passez-le sur HubSpot navigation menu et choisissez le menu construit dans Paramètres → Contenu → Navigation. Le header est un contenu global : la modification s'applique à toutes les pages.

Les panneaux sont associés par libellé : Applies to the menu item labeled doit être exactement le libellé de l'entrée de premier niveau (même orthographe, même casse). Seuls deux niveaux sont affichés ; un troisième est ignoré.

La recherche envoie les visiteurs vers la mauvaise page

La boîte de recherche du header envoie vers /hs-search-results. Si votre page de résultats est ailleurs, définissez Search results page path dans le module header et dans le module propre de la page de résultats.

Le sélecteur de langue est absent

Il ne s'affiche que si la page a au moins une traduction. Vérifiez que Show language switcher est activé dans le groupe Display du header, et que la page a des variantes linguistiques.

Pages système et espace membre

Mes pages système ne sont pas proposées dans la liste déroulante

Chaque template système de Mistral Pro n'apparaît que pour son propre type de page dans Paramètres → Contenu → Pages → Pages système : Error 404 et Error 500 pour les pages d'erreur, Password prompt, Search results, et les trois templates d'abonnement e-mail. Si aucun n'apparaît du tout, le theme n'est pas installé sur le compte que vous consultez.

Je ne peux pas attribuer les templates d'espace membre

Les quatre templates d'espace membre nécessitent Content Hub Pro ou supérieur. Sur les éditions inférieures, ils existent dans le Gestionnaire de conception mais HubSpot n'offre aucun endroit pour les attribuer. Voir Espace membre.

La connexion sociale n'apparaît pas sur la page de connexion

Elle est livrée désactivée. Saisissez d'abord vos propres identifiants d'application Google ou Facebook dans HubSpot, puis activez-les dans le module de connexion sociale de la page de connexion.

Mise en page et style

Un titre apparaît deux fois

Vous avez placé un module qui affiche son propre titre sous un Two-tone section heading. Désactivez Show section heading dans le groupe Display du module.

Une couleur modifiée sur un module ne suit plus les réglages du theme

C'est normal : une valeur définie dans l'onglet Style d'un module surcharge le réglage du theme pour ce module seulement. Réinitialisez le champ pour revenir à la valeur héritée.

Les ombres n'apparaissent pas sur les cartes

Les ombres sont désactivées par défaut (design plat). Activez-les dans Réglages du theme → Layout and spacing → Card and media shadows.

Les animations ne jouent pas (compteurs, défilement, orbite, rotation de l'équipe)

Vérifiez Réglages du theme → Layout and spacing → Motion and animations, puis l'interrupteur Behavior propre au module. La préférence « réduire les animations » du navigateur les arrête aussi, volontairement.

Une image paraît floue

La source téléversée est plus petite que l'emplacement qu'elle remplit. Téléversez une source au moins aussi large que l'emplacement et laissez HubSpot la redimensionner. Voir Images et marques.

Je ne peux pas modifier les fichiers du theme

Les themes de la marketplace sont en lecture seule pour que vous continuiez à recevoir les mises à jour. Pour modifier le code, clonez le theme (Outils de conception → clic droit sur le dossier du theme → Cloner) ; le clone ne reçoit plus les mises à jour. Avant de cloner, vérifiez que la modification n'est pas déjà un réglage du theme ou un champ de module.

Toujours bloqué ?

Voir Support — envoyez votre identifiant de compte, l'URL de la page et une capture d'écran.