The Astra theme is 100% translation-ready and compatible with WPML. This document will help you create a multilingual website with the WPML plugin.
Since WPML is a premium plugin, please make sure you’ve purchased the WPML license before proceeding.
How To Setup WPML
For translating your Astra-based website with WPML, you will need several plugins.
Install and Activate plugins
Let’s see how you can download and install these plugins:
Step 1 – Login to your WPML account and download the following plugins from the “Download WPML manually” section:
- WPML Multilingual CMS
- String Translation
- Media Translation
Step 2 – Login to your website backend and navigate to Plugins > Add New > Upload Plugin. Choose the plugin .zip file and click the “Install Now” button to install a plugin. Install all mentioned plugins this way.
Step 3 – Activate all installed WPML plugins.
Step 4 – When you activate the “WPML Multilingual CMS” plugin, you will see a notification in your Dashboard to start configuring WPML.
You can click the “Configure WPML” button on the notice or navigate to WPML > Setup. This will activate the Setup wizard.
Setup Wizard
The setup wizard will guide you through the whole multilanguage setup process and preparing your website for translation:
Step 1 – The first wizard option, “Languages”, is where you will add the languages you need. Choose your “Default language”. This is your primary language for your existing website content.
Next, you need to add all other languages you wish to translate your website to by clicking on the “+” icon. If you can’t find your language in the dropdown list, you can create a custom language.
For our example, we will use English (default), German and French languages:
Once you have added all languages, click on “Continue”.
Step 2 – In the next step, “URL Format”, you need to decide what will your URLs for different languages look like – different directories, different domains, or with added parameters.
Step 3 – On the third step (“Register WPML”) you need to add your “Site key”. You can find this by clicking on “Get a key for this site”. You will be transferred to the “Sites” page on the WPML website.
Also, you do this manually by going to your WPML account. Log in, navigate to “My Account”, and click on “Register WPML on your sites” (Account > Sites).
On the “Sites” page, click on the “Add new site” button. You will be asked to add your website URL and confirm if this is a development or production website.
Once you click on “Finish”, you will see a code – copy this code to the wizard field on your website. Click “Continue” to move to the next step.
Step 4 – In the fourth step, you should decide how you want to translate your website. You can choose to translate everything by yourself, with other users working on your site, or with external translation services.
If you’re creating a website for a client, you can also set a “Translation Manager” to choose the options and assign the translators.
Step 5 – “Support” is the step where you can opt-in to share your theme and plugin information with WPML to get faster support and compatibility alerts. For our example, we decided not to share this information.
Step 6 – If you’re running some third-party plugins like WooCoomerce or WPForms, the next step (“Plugins”) will recommend WPML components for these plugins (if any). If you need these to be multilingual too, we recommend you add these components.
To install and activate these components (plugins), mark them in the list and click “Install and Activate”. Otherwise, click on “Skip” to move to the last step.
Step 7 – For the last step, “Finish”, WPML will add a language switcher to the bottom of your footer. You can edit or disable this one, and enable other language switchers by navigating to WPML > Languages.
The WPML plugin is now set, and additional languages were added to your website. Now you need to translate your content, media, and options.
Media Translation Setup
Once you finish your WPML setup, you will see the notification to finish the Media Translation Setup. You can do this by clicking on the link in the notification or by navigating to WMPL > Media Translation.
Once you navigate to this page, click on the “Finish setup” button. This will load all of your website media and automatically copy the media name from the original language.
That’s it – your media translations are set.
In addition, if you wish to edit translations for your media at any time, you can click on the translation (pencil) icon for any media files in the list. Here, you will see the following settings:
- Translate the file name
- Use a different file – This can be used if you have a logo or images with translatable text
These additional settings are not obligatory, and you do them at any time for any media file.
Translating Pages, Posts, and Post Types in Astra
When you translate pages or posts with WPML, you get linked versions of pages or posts where each version is assigned a language.
We will show you how to create the translated version of your page in just a couple of steps:
Step 1 – Navigate to WPML → Translation Management and expand the sections with the content you want to translate. Select your items and scroll down to Step 2.
Step 2 -Choose the languages you want to translate into and select a translation method.
For the best translation quality, we recommend choosing Translate automatically. When selecting this option, WPML will use one of its integrated automatic translation engines, like DeepL and ChatGPT, to translate your content.
Step 3 – Finally, choose whether you want to review translations before publishing them to your site (if you’re translating automatically) and click Translate to begin.
Reviewing Translations
Once WPML finishes translating your content, go to WPML → Translations and click the Review button to start a review.
This will open a front-end editor which shows you what translations will look like on your website. If at any moment you’re unsatisfied with the quality, just click the Edit translations button to make changes.
Once you’re done reviewing, click the Complete Translation button to publish translations. Your content will now appear translated when switching languages on your site.
Translating Menus and adding a Language Switcher to the Header
Now that we have translated all pages and posts, it’s time to translate the menus and manage your Language Switcher settings so website visitors can choose the language they want.
Before editing your menus, please check if activating the WPML plugin affected any of your permalinks or your menu locations in any way, and correct this.
Translate Primary (or any other) Menu
Now let’s see how you can set your menus for each of the languages added. The menus can be translated similarly as pages or posts. Here, we’ll show you how to translate your Primary Menu:
Step 1 – Navigate to Appearance > Menus and select your Primary Menu. Your primary menu will be set for your default language. In our case, this will be English.
On the upper right corner of the “Menu Structure” section, you will notice the translation options similar to those you used for translating pages:
Step 2 – To start translating your menu, click on the language translation option. We choose to translate the menu in our example to the French language.
Step 3 – Start by giving your translated menu a name (we used “Primary Menu – French”). You will notice that the language and the original menu you’re translating are already selected. Click on the “Create Menu” button to create the translation.
Step 4 – Once your menu translation is created, you can add menu items. Keep in mind that you will see only translated pages and posts in your item list. Pages and posts that have not been translated into the language of the menu you’re editing will not be available.
Step 5 – Once you add the appropriate language versions of pages, posts, and other items to the translated menu, click on “Save Menu” to save the changes you made.
You can translate your other menus this way too.
Managing the Language Switcher
Our final step here is to manage the Language Switcher and add it to the desired location. WPML provides its own out-of-the-box Language Switcher that can be added to your menus, widgets, and footer.
You can add Language Switcher and manage all its settings at WPML > Languages. Here you will find two groups of settings:
- Global “Language Switcher options” applied to all language switchers on your website,
- Individual settings for each of the language switchers added to your website
In the global “Language Switcher options”, you will find the following settings:
- Order of languages: Set the order in which available languages will be shown in the switcher.
- How to handle languages without translation: Choose if you want to with the content without translation – skip it or link it to the home page in the selected language.
- Preserve URL arguments: If you use any of the plugins that need URL arguments to function properly, add these here to keep them when switching languages.
- Additional CSS: You can use this option to add styling to your Language Switchers using CSS.
Individual settings can be applied to each of the language switchers in different language switcher sections. These sections are:
- Menu language switcher.
- Widget language switcher.
- Footer language switcher.
- Link to translation of posts.
Adding A Language Switcher
As an example of how to edit these settings and add the language switcher, we’ll be adding the Language Switcher to the Primary Menu. Please follow these steps:
Step 1 – Navigate to WPML > Languages and scroll down to the “Menu language switcher” section.
Click the “Add a new language switcher to a menu” button. This will open a popup for adding a new menu language switcher.
Step 2 – Choose to which of your menus you would like to add this language switcher. We will choose the “Primary Menu” here.
Step 3 – Select if you want to show the languages as a dropdown menu or the list of languages.
Step 4 – Decide how the languages should be represented: by the flag, native language name, or the name in the current language. Also, here you can select if you want to show or hide the “current language” option.
Step 5 – In the end, set the language switcher colors. Click save to add your Language Switcher:
Great job, your multilingual website is ready for visitors.
Other WPML Settings
In addition, at WPML on your WordPress dashboard, you can find a lot of additional settings for your multilingual website.
For more details, or help and assistance working the WPML plugin, you can check the official WPML documentation.
