Prime MOQ

Customizing the Limit Message Text

Write the exact wording a blocked shopper sees, per rule and per language, using the built-in placeholders or your own voice entirely.

Prime MOQ Team

Prime MOQ Team

Updated ยท 2 min read

Short answer

The Messages card on a rule controls the text a shopper sees when their cart does not meet it, with one message for the minimum condition and one for the maximum, per language your store supports. Placeholders such as {{minimum_quantity}} fill in automatically, and you can rewrite the text entirely without them.

  • One minimum message and one maximum message per language, per rule.
  • Placeholders are optional. You can write the message entirely in your own words.
  • An empty field auto-fills with your shop default, so it is normally editing rather than starting blank.
  • A field saved genuinely empty falls back to a generic hardcoded message, not your template.

What it controls

The Messages card on the rule editor sets the exact text shown to a shopper when their cart does not meet the rule: one message for the minimum condition, one for the maximum, per language your store supports.

Placeholders

The built-in default text uses placeholders that are filled in automatically.

BucketMinimum message defaultMaximum message default
QuantityThe minimum quantity for {{product_name}} is {{minimum_quantity}}The maximum quantity for {{product_name}} is {{maximum_quantity}}
ValueMinimum order value is {{minimum_total_value}}Maximum order value is {{maximum_total_value}}
WeightThe minimum total weight is {{minimum_total_weight}}The maximum total weight is {{maximum_total_weight}}

You can rewrite the message entirely in your own voice. Placeholders are optional, not required.

Customize a rule's message

Open the Messages card in the rule editor.

Pick the language. If your store publishes several languages, use the language tabs to choose which one you are editing. The primary language is shown first.

Edit the minimum or maximum message. Type your wording into Minimum limit message or Maximum limit message. An empty field is pre-filled with your shop's default template for that language and limit type as real, editable text rather than a greyed-out placeholder, so you are editing rather than starting from a blank box.

Reset if needed. Click Reset next to either field to discard your edit and revert to the shop's saved default for that language and bucket.

Save the rule.

Why leaving a field truly empty is a bad idea

If a message field is saved genuinely empty, rather than showing the default as placeholder text, the checkout enforcement and the product-page widget fall back to their own generic hardcoded message instead of your templated one. That is a silent mismatch between what you saw in the admin and what shoppers see.

In practice this rarely happens, because empty fields auto-fill with the effective default the moment you focus a language and bucket. If you deliberately clear a field, be aware it will not stay visually blank at checkout.

Unsupported languages

A shopper browsing in a language your store has not published a translation for sees the message in your store's default language.

Common mistakes

  • The message does not match what you typed. Check you edited the correct language tab. Each language has independent text.
  • A placeholder shows literally as {{minimum_quantity}}. The raw template text was pasted in manually. Edit through the Messages card rather than pasting exported text from elsewhere.
  • Retyping the same wording on every rule. Set it once as a shop-level default instead. See Default Message Templates.

Frequently asked questions

Can I write the message without using placeholders?

Yes. Placeholders are convenience, not a requirement. A fixed sentence such as "This item ships in cartons of 6, please order in multiples of 6" works perfectly well and often reads better than a templated one.

Do I have to write a message for every language?

No. Any language you have not written text for falls back to your shop default, and a shopper browsing in an unpublished language sees your store's default language.

Why is my placeholder showing as literal text on the storefront?

The template text was most likely pasted in by hand rather than produced by the Messages card. Retype the field through the card, or click Reset to restore the default and edit from there.

What is the difference between the minimum and maximum message?

They cover the two directions a rule can fail. The minimum message shows when the cart is below your floor, the maximum message when it is above your ceiling. A rule that only sets one of the two only ever shows that one.

Where do I change the message colours and font?

On the Design page, not here. Messages controls wording per rule, Design controls one global appearance shared by every rule, which is why you cannot style a single rule's message differently from the rest.

Can I preview my wording before saving?

Yes. The Preview card in the right-hand column shows the exact message at the quantity you set, using your current text, without leaving the page.

Best for: Any rule whose default wording does not explain the limit clearly enough for your shoppers.

Applies to: All limit types, Multi-language Shopify stores

Did this answer your question?

Related articles

Still stuck?

Tell us what you are trying to set up and we will reply within 24 hours.

Contact support