Internationalization
You may choose to publish your form in any number of languages. We make it easy to ensure you've provided translations for all prospect-facing text.
You can even leverage your prospect's language as a condition to control conditional fields, sections, actions, conditional navigation through multi-page forms, redirects and "thank you" messages.
Form Internationalization:
Add a Language
Click the "Internationalization" icon (a globe) shown in the image above.
Click the "Add a New Language" button, and search for the language you'd like to add. You may add as many languages as you need.
Form Internationalization – Add a New Language:
Providing Translations
Paminga offers two ways for you to add translations to your forms.
The Set Language Dialog
The Set Language Dialog provides a single place where you can add translations for all customer-facing text in your form.
This includes:
- Field Labels
- Placeholders (translation is only required if you've specified a placeholder for a field)
- Default Value (translation is only required if you've specified a default value for a field)
- Validation Error Messages (translation is only required validation rules that are enabled)
- Headings and Paragraphs
- Buttons
- "Thank You" messages you may choose to display when your form is submitted
Form Internationalization – Set Language Dialog:
If your form consists of multiple pages, the Set Language Dialog will have a "Next" button at the lower right that will allow you to move through the pages of your form, providing translations for each.
You may not be able to get all translations in place at once. No problem! A "Save" button appears on the last page available in the Set Language Dialog. Click that button to save your progress.
Returning to the Set Language Dialog
You may return to the set language dialog any time by clicking the "globe" icon for internationalization, and clicking the "edit" icon for the language you want to work on.
Form Internationalization – Edit Language:
When Editing Your Form
Once you've added and saved a language to your form, you may close the Set Language Dialog and provide translations by editing the form as you normally do.
It's easy to change the language you are viewing/editing your form in.
Switching Languages in Your Form
You may toggle between different languages by clicking the "globe" icon for internationalization, then clicking on the language you wish to view your form in.
Validating Translations Are Complete
Paminga will make it very obvious when you've added a language but not yet provided all required translations.
Paminga also prevents you from publishing a form with errors (like incomplete translations), ensuring that you do not publish a form that cannot provide an excellent experience to your prospects.
Changing the Default Language
Every form has a default language. Currently, the default always starts out as English. We plan on making it possible to set your default language globally in the future.
The default language comes into play when your form is viewed on your website: if a prospect's web browser is set to use a language for which you have not provided a translation*, your form will be displayed in its default language.
*Unless you've chosen to embed your form with a particular language specified.
You may change the default language for your form by clicking the "globe" icon for internationalization, then clicking the "star" icon next to the language you'd like to set as the default.
Form Internationalization – Setting a Default Language:
Embedding Your Internationalized Form
Clicking the "Embed" button in the lower left corner of the form builder reveals the "Embed Your Form" dialog.
If your form is published in multiple languages, you'll see a "Language" drop down at the upper right.
This dialog will allow provide you:
- An option for each language you've added to your form
- An "Infer from Browser Settings" option
In A Specific Language
If you select a specific language, the embed code will only render your form in that language.
Infer Language From Browser Settings
If you choose "Infer from Browser Settings", the form renderer will detect the prospect's language as set in their web browser.
If your form has been published in the prospect's preferred language, your form will be rendered in that language. Otherwise, it will be rendered in your form's default language.
Form Internationalization – Embedding Your Form:
Programmatic Control of Form Language
Your web developers may control the language your forms are rendered in programmatically.
This is done by including a "data dash attribute" of data-lang
in the <div>
that wraps your embed code.
So including data-lang="ES"
will cause your form to be rendered in Spanish.
Including data-lang="EN"
will cause your form to be rendered in English.
You'll see this data-lang
attribute in the embed code if you chose to embed your form in a specific language.
If you specify a data-lang
attribute for a language that has not been added to your form, your form will be rendered in its default language.