WPML language switcher

Integration 3 min read

This integration renders a language switcher in the theme's style, instead of the one WPML draws itself.

In practice: the switcher looks like part of the header rather than an insert from elsewhere, and behaves the same way on every screen size. Flags and language names come from the same plugin.

A useful side effect: WPML's own switcher stylesheets are removed, so they cannot conflict with the theme.

#What it does not do

Say this plainly, because it sets the right expectation.

The integration does not translate. It does not touch how translation happens or how translated content is displayed.

All of the multilingual work, the languages, the translations and the page addresses, stays with WPML and is configured in its own documentation.

Our part is exactly one thing: the switcher.

Translating your site and setting up RTLThree different jobs live under the word "translation", and confusing them is why people get stuck. They are solved separately. Translating interface strings The words the theme and plugins...How-to Guide

#What you need

WPML, installed and active. This integration is an overlay on it.

The order: WPML first, with your languages configured in it, then our integration. Without languages there is nothing for a switcher to show.

#Where it is configured

This integration has no page in the Integrations block, because there is nothing in it to configure.

Every switcher setting lives where the switcher is rendered, in the theme's navigation settings: the switcher source, the provider, and its position in the header.

The reason in one line: the connection to the service is identical across all our themes, and the switcher's placement is different in each one.

#Integrations are part of the theme

This integration is licensed with the theme, not on its own.

Integrations are premium functionality for customers running a Pro license of one of our themes. They are written against our themes and expect them, and we cannot support or take responsibility for what one does inside somebody else's theme. See how theme integrations work.

#Common questions

Why is my switcher empty?

Because no languages are configured in WPML, or only one is, and the switcher shows exactly what the plugin hands it rather than inventing entries of its own.

Can I use WPML's own switcher instead?

Yes, deactivate this integration and WPML draws its own again with its own styling, since removing those stylesheets is something we do only while ours is on.

Does this handle translating the admin interface?

No, that is a different job done by the translation plugin reading our text domains, while this integration is only about the control your visitors click.

Do I need this if my site is in one language?

No, and neither the plugin nor the integration is worth installing for a single language site.

The switcher does not appear at all

Check that WPML is active and has more than one language, then check the navigation settings where the switcher is enabled and positioned, and if both look right clear any page cache, because a cached header is the most common reason a correctly configured switcher is invisible.

#Still stuck

Open a support ticket with the languages you configured and a screenshot of the navigation settings.

Last updated

Was this article helpful?

Related articles

FIND THE ONE THAT FITS YOUR PROJECT

Import a demo, swap the content, adjust the layout. Modern WordPress under the hood, fast even when the site fills up.