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
Section titled “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_rating_star} |
Product’s average star rating | “4.8” | FREE |
{product_number_of_star} |
Number of reviews on the product | “126” | FREE |
{product_metafield} |
Product metafield value | (varies) | DIAMOND |
{variant_metafield} |
Variant metafield value | (varies) | DIAMOND |
{countdown} |
Countdown to end date, Style 1 | “12Days 20Hrs 50Mins” | GOLD |
{countdown_2} |
The same countdown in Style 2, each unit boxed | “12 : 20 : 50” | GOLD |
Sami discount variables
Section titled “Sami discount variables”These four variables read their value from a discount created on the app’s Discounts page. In Insert dynamic text they are grouped under the Sami Discount tab.
| Variable | Description | Example output |
|---|---|---|
{sami_discount_value_percent} |
The discount percentage of the Sami discount applied to the product | “20%” |
{sami_discount_value_amount} |
The discount amount of the Sami discount applied to the product | “Save 10.00” |
{sami_discount_code} |
The discount code of the Sami discount applied to the product (code discounts only) | “SUMMER20” |
{sami_new_price} |
The product price after the Sami discount is applied | “Now 40.00” |
Product review variables
Section titled “Product review variables”These two variables read their value from the review app your store runs — Judge.me, Loox, Junip, CWILL(Trustoo), LAI Product Reviews, or AG Product Reviews. In Insert dynamic text they sit under the Advanced tab.
| Variable | Description | Example output |
|---|---|---|
{product_rating_star} |
The product’s average star rating, always to one decimal | “4.8” |
{product_number_of_star} |
How many reviews the product has | “126” |
Next steps
Section titled “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.