Token / mention system

Use tokens like {discount}, {product}, {timer} in post-purchase offer text for runtime personalization.

This article is a draft and may be incomplete or change before publishing.

Tokens in the rich-text fields of post-purchase offers are replaced at runtime with live offer details. Personalize headings and body text without hardcoding values.

Tokens work in the rich-text fields of Post Purchase offer widgets. Cart Editor fields don't use them; some of those have their own double-curly placeholders instead (for example {{cart_quantity}} in Cart Title), described in the field's help text or behind the variables button next to the field.

Available tokens

{discount}

Discount label: a percentage such as "15%", or a formatted amount such as "$5.00". Empty when the offer has no discount.

{product}

Product title

{original-price}

Formatted original price

{current-price}

Formatted discounted price

{savings}

Savings text, such as "(Save 15%)". Empty when the offer has no discount.

{timer}

Live countdown — only inside the Timer widget

{first-name}

Buyer's first name. It has no toolbar button; if you type it yourself, it is filled in when a first name is available.

Where each token is offered

Text and Text & image widgets (Heading, Body text): {discount}, {product}.
FAQs widget (Title, Question, Answer): {product}, {discount}.
Timer widget (Heading, Body text): {timer}.
Main product info widget: Text above buttons and Text under buttons offer {discount}, {product}; Product title offers {product}; Product price offers {original-price}, {current-price}, {savings}.

How to insert

In a post-purchase rich-text field, click the token's button in the editor toolbar. Each button is labeled with its token, and hovering shows "Insert" plus the token. The token appears in the text as a single item with a dotted underline and is replaced with live data on the buyer's screen.

Example

Heading input: "Add {product} for {discount} off!"

Buyer sees: "Add Vitamin C Serum for 20% off!"

Empty token fallback

If a token has no value (for example {discount} on an offer with no discount), it is replaced with nothing and the rest of your text stays as written — so check that your sentence still reads well without it.