# Customizing the Limit Message Text

> Source: https://primemoq.app/help/storefront-and-messages/customize-the-limit-message
> Collection: Storefront & Messages
> Updated: 2026-08-02

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

**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.

## Key takeaways

- 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.

| Bucket | Minimum message default | Maximum message default |
|---|---|---|
| Quantity | `The minimum quantity for {{product_name}} is {{minimum_quantity}}` | `The maximum quantity for {{product_name}} is {{maximum_quantity}}` |
| Value | `Minimum order value is {{minimum_total_value}}` | `Maximum order value is {{maximum_total_value}}` |
| Weight | `The 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](/help/storefront-and-messages/default-message-templates).

## FAQ

### 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