Ctrlk
WebsiteGithubSlack
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Getting Started

Install and configure the Weglot plugin for Craft CMS.

Weglot integrates with your Craft CMS site and makes it multilingual in a few minutes. Here is what it does:

  1. It creates a URL for each language — for example /fr/about or /es/about — without creating any new entries in the Craft control panel.

  2. On those URLs, it serves the translated content.

  3. It adds a language switcher to your pages and injects the hreflang tags in the <head> for SEO.

1. Install the plugin

In the Craft control panel, go to Settings → Plugins, open the Plugin Store, search for Weglot, and press Install.

From your project root, require the package and install the plugin:

composer require weglot/craft-translate
php craft plugin/install weglot

2. Configure the mandatory settings

Open the plugin settings (Settings → Plugins → Weglot) and fill in the three required fields:

  • API Key — your Weglot project key. If you don't have one, create your account; a Register on Weglot button is also shown in the settings until a valid key is saved.

  • Original Language — the source language of your Craft site (the language your content is written in).

  • Destination Languages — the languages you want your site translated into, entered as a pipe-separated list, for example fr|es|de.

Save the settings. Weglot validates your API key, syncs your configuration, and the language switcher appears on your site.

The Original Language and Destination Languages menus are populated from the 110+ languages Weglot supports, fetched live from your account.

Next step: head over to Plugin settings to control what gets translated — exclusions, dynamic content and search integrations — and to customize the language switcher.

PreviousRequirements
NextPlugin settings