Contact Form 7 allows you to create, customize, and manage front-end forms for your site. In this tutorial, we provide step-by-step instructions on how to make these forms multilingual using WPML.
Here is a short video that explains the process of translating form built using the Contact Form 7 plugin:
On This Page:
- Getting Started
- Translating Your Forms
- Non-translatable Form Elements
- Known Issues
- Getting Help
Start by installing and activating the following plugins:
- Contact Form 7 plugin
- Contact Form 7 Multilingual plugin
- WPML core plugin and WPML String Translation add-on
If you’re new to WPML, check out our Getting Started Guide. It quickly walks you through different translation options you can use.
To translate your forms, follow these steps:
To create your form, go to Contact → Add New. When completed, you will get a shortcode for your contact form. Copy it to later insert it into your contact page.
Now, it’s time to translate the form. WPML provides you with different ways of doing this.
If you use the Translate What You Choose mode, you can automatically translate your contact forms from the Translation Management dashboard. Simply go to WPML → Translation Management, find and select your form, and click to automatically translate it.
Go to WPML → Translation Management to send all types of content, including contact forms, for translation.
You can send any content, including forms, to be translated by your own translators, or by one of many professional translation services integrated with WPML.
You can find detailed instructions on how to do this in our guide about using WPML’s Translation Management.
Alternatively, you can translate the form yourself. To do this, edit the form and in the Language box, click the plus icon corresponding to the language you want to translate your form into.
This takes you to WPML’s Advanced Translation Editor (ATE), where you can translate the form and placeholder texts. If you have translation credits, you’ll see the translations automatically filled in. If you don’t have credits, you need to add the translations by yourself.
All the forms you create include a Submit button. Contact Form 7 also gives you the option to add checkboxes, radio buttons, and drop-down menus to your forms. This allows you to create fields with multiple choices, like a checkbox for users to pick their country of residence.
To translate the Submit button and the values of fields from checkboxes, radio buttons, and other select field types, you need to search for the text in the Advanced Translation Editor.
When you search for the field value in the Advanced Translation Editor, you may see the text appear twice, labeled as shortcode and shortcode-attr. Only translate the field labeled as shortcode attribute (shortcode-attr). This shortcode attribute (shortcode-attr) holds the value that needs translation, while shortcode (shortcode) represents the code and should never be translated.
- Search for the value of the field that you want to translate. In our example, we are searching for the Submit button.
- Click the plus icon next to your text labeled as a shortcode attribute (shortcode-attr) and enter the translation.
- Save the translation by clicking on the check mark in the green box.
Repeat these steps for all values coming from the buttons or multiple choice fields in the form.
Now you need to insert your form into a post, page, or widget in the default language. To do this, simply insert the Contact Form 7 block and select your form using a dropdown.
Finally, you need to translate the pages, posts, or widgets that hold the forms. Just like translating the forms, you can send these to be translated by others, or you can do it manually yourself.
To translate it yourself, edit the post or a page and use the Language box to translate or duplicate it.
Make sure to translate only the texts. Do not change anything within the shortcode. WPML automatically displays the form in the correct language.
There are certain form elements whose texts come from your browser and not Content Form 7 or WPML. This includes elements like the Browse and Upload File buttons and reCAPTCHA.
A user visiting your site will see these fields displayed based on the default language of their browser.
In case you need help translating your forms built using Contact Form 7 and WPML, visit WPML’s support forum.