Theme Documentation

Why Am I Not Seeing the Language Switcher on My Pages?

HubSpot’s language switcher will only appear on pages that are set up as multilingual. If you are in the Theme Settings or Site Header partial, you’ll need to switch the preview to a multilingual page (where a language appears below the page name).


Troubleshooting Language Switcher Visibility

When working with multilingual HubSpot sites, you’ll encounter the language switcher visibility issue most commonly in two scenarios: during theme customization and when editing page templates.

In the Theme Settings panel, the language switcher module won’t display in the preview pane unless you’re viewing a page that has been specifically configured for multiple languages. To resolve this, navigate to your page tree and look for pages that show a language code (such as “EN” or “ES”) beneath the page name. Select one of these pages as your preview context before making adjustments to header settings or language switcher styling.

When editing templates in the drag-and-drop editor, you may notice the language switcher appears empty or missing entirely. This occurs because you’re viewing a template rather than a live multilingual page. To see the switcher in action, exit the template editor and navigate to an actual page that’s part of your multilingual content strategy.

The language switcher automatically detects which languages have corresponding versions of your current page. If you’ve created a page in English but haven’t yet created the Spanish or French versions, those language options won’t appear in the switcher. You can verify this by checking your content mapping in HubSpot’s multi-language settings under Settings > Website > Multi-language.

Pro tip: If you’re testing language switcher functionality during development, create test pages in each target language first. This allows you to see exactly how the switcher will behave for your visitors and ensures proper styling across all language variants. Remember that the switcher only displays languages that have published content - draft pages won’t trigger the switcher to appear.