Skip to content
Esc

Start typing to search the docs.
On this page
How-to Updated Aug 16, 2026

Multilingual messages

Use Multilingual Messages to show your rule message in different languages. Add a default message first, then add translations for the languages you want to support. If a translation is not available, customers will see the default message.

Applies to
  • Premium plan
  • Stores that want to show rule messages in more than one language
Doesn't apply to
  • Basic plan
  • Automatic translation of other store content
On Basic? Write one clear message instead

Showing the rule message in the customer’s language makes it easier for them to understand what they need to change before continuing.

Before you start

  • Make sure your store is on the Premium plan, which includes Multilingual Messages.
  • Prepare the message you want to use as the default.
  • Prepare the translated message for each language you want to add.

Steps

1. Install Nex Validator

If Nex Validator is not installed yet, install it from the Shopify App Store and approve the required permissions. If it is already installed, skip to the next step.

Install on Shopify Already installed? Skip ahead

2. Open the rule you want to use and enable Multilingual Messages.

3. Choose your default language and enter the main message in Default Message. This message is shown when a customer uses a language you have not added a translation for. Example — Language: English, Message: “Your cart must contain at least 5 items.”

4. Click Add message translations, select the Language, and enter the translated version of the same Message. Example — Language: Spanish, Message: “Tu carrito debe contener al menos 5 artículos.”

5. Repeat step 4 for any other languages you want to support. Make sure the rule is Enabled, then click Save.

Verify it worked

  1. Open the store in a language you added and create a cart that breaks the rule → the translated message should appear.
  2. Test a language that does not have a translation → the default message should appear.
  3. If you show messages in both the cart and checkout, check that the correct message appears in both places.

Keep translations in step

If you change a rule value, remember to update the number in every translated message too. For example, if the minimum changes from 5 items to 10 items, update both the default message and every translation from 5 to 10.

Frequently asked

What happens for a language I have not translated?

The default message. Always write a good default — it is what most customers see.

Does it translate automatically?

No. You provide each translation, which is the right way round — an auto-translated refusal reads badly.

Does it use the customer's browser language or the store language?

Test it against your own setup before relying on it, particularly on a Shopify Markets store where language and market do not always line up.

See also: Write a custom message · Plans and what is included · Messages