Dynamic variables reference

Complete reference for all dynamic variables you can use in badge and label text content.

Dynamic variables display live product and customer data inside your badge text, replaced with the actual value when a customer views the product.

For example, a badge with the text Save {sale}! would display as Save 25%! on a product that is 25% off.

Variable reference table

Variable	Description	Example output	Plan
{product_vendor}	Product vendor name	"Nike"	FREE
{product_type}	Product type	"T-Shirt"	FREE
{product_sku}	Product SKU	"SKU-12345"	FREE
{inventory}	Total items in stock	"42"	FREE
{sale}	Discount percentage	"25%"	FREE
{sale_amount}	Discount amount	"$10.00"	FREE
{product_variant_count}	Number of variants	"3"	FREE
{customer_order_total}	Customer's total orders	"5"	FREE
{customer_spent_total}	Customer's total spent	"$250.00"	FREE
{product_metafield}	Product metafield value	(varies)	DIAMOND
{variant_metafield}	Variant metafield value	(varies)	DIAMOND
{countdown}	Countdown to end date	"2d 5h 30m"	GOLD

Notes

Sale variables and auto-hide {sale} and {sale_amount} support an option to auto-hide the badge when the product isn't on sale, avoiding "0%" or "$0.00" on full-price products.

Metafield variables {product_metafield} and {variant_metafield} require the DIAMOND plan. Selecting one shows a field for the metafield's namespace and key — for example, custom.material or custom.care_instructions. The app pulls that value for each product or variant.

Countdown timer {countdown} requires the GOLD plan and an end date set under Display > Visibility Date & Countdown in the badge editor. It updates in real time, showing the remaining time until that date. Choose Style 1 or Style 2 in Insert Dynamic Text before copying the token.

Variables are case-sensitive — type them exactly as shown, including the curly braces. {sale} works; {Sale} or {SALE} will not.

---

Next steps

• Using dynamic variables — learn how to add variables to your badge text step by step.

• Create a text badge — build your first text-based badge with dynamic content.