Variables you can use in block text

Updated Sep 10, 20263 min read

Every text field in a campaign block accepts variables. Write a variable as {{name}} — two braces, no spaces — and Hype replaces it on the storefront with the live value for that shopper. For example, Add {{pending_amount}} more to unlock free shipping becomes Add $18.50 more to unlock free shipping.

To see the list for the block you are editing, click Variables & formatting in the block's setup modal. The panel is titled Block Variables and shows exactly the variables that block supports.

Available everywhere

Variable	What it shows
`{{discount_code}}`	Promotional code identifier (e.g., SAVE20, WELCOME10, FREESHIP)

Variable	What it shows
`{{discount_code}}`	Promotional code identifier
`{{discount}}`	Discount amount/percentage (e.g., 10%, $10, 25%)

Product price block

Variable	What it shows
`{{discount_amount}}`	Discount amount (e.g., $20)
`{{discount_percentage}}`	Discount percentage applied to the product (e.g., 10%, 25%)
`{{product_price}}`	Original product price before discounts (e.g., $45.00)
`{{discounted_price}}`	Discounted product price after applying the discount (e.g., $30.00)

Variable	What it shows
`{{eligibility_total}}`	Minimum requirement for eligibility (e.g., $100, 4 items)
`{{eligibility_pending}}`	Minimum pending requirement to qualify (e.g., $100, 4 items)
`{{discount}}`	Gift value (e.g., Free, 10%, $25)
`{{quantity_total}}`	Maximum number of gifts a customer can add to their purchase
`{{quantity_pending}}`	Remaining number of gifts the customer is eligible to add

Progress bar

Variable	What it shows
`{{min_cart_amount}}`	Minimum cart value for discount eligibility (e.g., $100, $250)
`{{pending_amount}}`	Remaining amount needed to reach the minimum cart value for the discount
`{{next_discount}}`	Type of the next discount (e.g., Free gift, Free shipping or Amount off)

These extra variables depend on the type of goal you are writing for:

Goal type	Variable	What it shows
Free gift	`{{discount}}`	Gift value (e.g., Free, 10%, $25)
Free gift	`{{total_gift_quantity}}`	Maximum number of free gifts that can be added to the cart
Free gift	`{{pending_gift_quantity}}`	Number of gifts still pending to be added
Free shipping	`{{shipping_limit}}`	Maximum shipping rate excluded by free shipping (e.g., $25)
Order discount	`{{discount}}`	Discount value for amount off (e.g., $10, 15%)

Volume discount selector

Variable	What it shows
`{{eligibility}}`	Minimum purchase requirement (e.g., $100, 5 items)
`{{discount}}`	Discount amount/percentage (e.g., 10%, $10, 25%)

Volume discount table

Variable	What it shows
`{{eligibility}}`	Minimum purchase requirement (e.g., $100, 5 items)
`{{discount}}`	Discount amount/percentage (e.g., 10%, $10, 25%)
`{{discount_amount}}`	Discount amount (e.g., $20)
`{{discount_percentage}}`	Discount percentage applied to the product (e.g., 10%, 25%)
`{{min_quantity}}`	Minimum quantity required for the tier (e.g., 3, 5)
`{{unit_discounted_price}}`	Price per unit after discount (e.g., $8.00)
`{{final_discounted_price}}`	Total price after discount for the tier quantity (e.g., $24.00 for 3 units)

Rules

Use the exact spelling above. An unknown variable is left in place as literal text, so shoppers would see {{discout}} on your storefront.
Do not put spaces inside the braces. Write {{discount}}, not {{ discount }}.
Only the variables listed for a block work in that block. {{min_quantity}} in an announcement bar will not resolve.
Money variables are formatted with your store's money format and the shopper's market currency.

Was this article helpful?

Still stuck?

Ask a follow-up and we'll see it came from “Variables you can use in block text”.

Opens chat with your question and a link to this article.