Translations

Written By Floris de Vries

Last updated 2 days ago

The Translations settings allow you to customize all customer-facing text used by the calculator. This includes field labels, placeholders, button text, validation messages, and several system strings.

Translations are managed per calculator and support every locale that is published in your Shopify store.


How translations work

Translations are generated only for elements that exist in the current calculator.

  • If a field is added, its labels and messages become available for translation.

  • If a field is removed, its translation entries are automatically removed.

  • You only see translation fields that are relevant to the current calculator.

This keeps the translation interface clean and focused.


Supported languages

Each calculator supports every language that is enabled and published in your Shopify store. The language tabs are derived directly from your Markets / Languages setup. The active language on the storefront is detected automatically; English is used as the fallback when a translation is missing.


Field translations

For each input field in the calculator you can translate:

  • Field label โ€“ the text shown next to or above the input.

  • Field placeholder โ€“ hint text shown inside the input.

  • Option labels โ€“ every option of a dropdown, radio, swatch, font picker or color picker.

  • Rich text content โ€“ the HTML body of a Rich Text block (per language).

  • Heading on a Divider โ€“ the optional label of a divider.

  • Checkbox checked / unchecked text โ€“ the human-readable status saved in the line item properties.

  • Font and font color labels โ€“ labels and section headings of a Font Picker.


System and UI text

In addition to field labels, you can translate:

  • Final price label โ€“ only when the calculator shows the final price block.

  • Upload loader text โ€“ shown while files are being uploaded.

  • For each file upload field: button text, dropzone main message, file count message and size message.

  • Customizer placeholder text โ€“ the placeholder shown over each personalised field in the live preview.

  • Computed property labels โ€“ if you defined custom variables that are exposed as line item attributes, their labels are translatable here.

This ensures a fully localized experience for customers.


Error messages

You can customize all validation messages shown to customers, including:

  • Required field โ€“ displayed when a required field is not filled in.

  • Minimum value error / Maximum value error โ€“ for number inputs.

  • Max files error / Total size error / File type error โ€“ for file uploads.

  • Minimum price / Maximum price โ€“ when the calculated price falls outside the allowed range.

Dynamic placeholders such as {min}, {max}, and {count} are automatically replaced with the correct values.


Best practices

  • Always translate all active languages used in your store.

  • Keep labels short and clear; use placeholders for hints, not as labels.

  • Review error messages for clarity and tone.

  • For Rich Text and Customizer placeholders, double-check formatting and spacing in each language.


๐Ÿ’ก Tip:Translations are calculator-specific. If you use multiple calculators, each one can have its own optimized wording per language.