Available variables for Flows
Relevant to:
You can use variables in your flows to display dynamic content tailored to each customer.
This guide provides a reference to all available variables, organized by flow type.
Before you start
- Some flows also utilize the Notification node, which uses different variables than those listed in this guide. See the list of available variables for the notification node for more information.
Cancellation prevention variables
Use the following variables when building your Cancellation prevention flow:
Section |
Variable |
Description |
Example |
| Landing page > Free gift reminder > Content | {product_title} |
Displays the title of the product added to the cart. | You added Premium Coffee Beans to your cart. |
| Landing page > Credits balance > Content | {available_balance} |
Displays the customer’s available store credit balance. | You have $15.00 in credits |
| Survey response pages > I already have more than I need > Delay claimed > Content | {delay} |
Displays the length of the delay the customer chose. | You’ve delayed your order by 3 weeks |
| Survey response pages > I already have more than I need > Delay claimed > Content | {rescheduledDate} |
Displays the new rescheduled date after applying the delay. | Your order has been rescheduled to October 22, 2025 |
| Survey response pages > Product is not worth the price > Discount claimed > Content | {discount} |
Displays the discount applied to encourage retention. | We’ve applied a 20% discount to your subscription |
| Survey response pages > I want a different product or variant > Swap claimed > Content | {newProductVariantName} |
Displays the name of the product or variant the customer swapped to. | You switched to Vanilla Protein Powder |
| Survey response pages > I want a different product or variant > Swap claimed > Content | {previousProductName} |
Displays the name of the product the customer swapped away from. | You replaced Chocolate Protein Powder |
| Survey response pages > I didn’t see the results I wanted > Swap claimed > Content | {newProductVariantName} |
Displays the new product or variant chosen after the swap. | You swapped to Extra Strength Formula |
| Survey response pages > I didn’t see the results I wanted > Swap claimed > Content | {previousProductName} |
Displays the original product before the swap. | You replaced Standard Formula |
| Survey response pages > Subscribing is not worth it > Discount claimed > Content | {discount} |
Displays the discount applied to retain the customer. | Stay subscribed and save 15% |
| Survey response pages > Other reason > Discount claimed > Content | {discount} |
Displays a discount applied when “Other reason” is chosen. | We’ve added a 10% discount to your subscription |
| Survey response pages > Gaming prevention > Skip fallback claimed > Content | {originalDate} |
Displays the original scheduled shipment date before fallback rules apply. | Your order is still scheduled for September 30, 2025 |
| Customize standard text | {frequency} |
Displays the frequency value of the subscription. | Delivered every 2 weeks |
| Customize standard text | {unit} |
Displays the time unit for the subscription interval (day, week, month). | Every 1 month |
| Customize standard text | {discount} |
Displays the discount applied to the product or subscription. | You save $5.00 each order |
| Customize standard text | {nextShipmentDate} |
Displays the date of the customer’s next scheduled shipment. | Your next shipment is on November 12, 2025 |
| Customize standard text | {title} |
Displays the title of the product in the subscription. | Organic Matcha Tea has been added to your order |
| Customize standard text | {from} |
Displays the original product (or variant) that the customer is swapping away from. | You are swapping Chocolate Protein Powder |
| Customize standard text | {to} |
Displays the new product (or variant) the customer is swapping to. | for Vanilla Protein Powder |
| Customize standard text | {price} |
Displays the product price. | Your subscription price will be updated to $19.89. |
| Customize standard text | {quantity} |
Displays the quantity of items in the subscription order. | You’re receiving 3 bags of coffee. |
| Customize standard text | {interval} |
Displays the interval of the subscription cycle. | Every 2 weeks |
| Customize standard text | {available_balance} |
Displays the customer’s available balance of store credits. | You have $10.00 in store credits |
| Customize standard text | {presentment_currency} |
Displays the currency in which the customer sees product pricing. | All prices shown in USD. |
| Customize standard text | {store_currency} |
Displays the store’s base currency. | Your store currency is CAD |
Cart variables
Use the following variables when building your Cart flow:
Section |
Variable |
Description |
Example |
| Banner > Banner text | {{product_title}} |
Displays the title of the product added to the cart. | You added Premium Coffee Beans to your cart. |
| Text area > Text or Product > Percent savings text or Buttons > Primary button text or Buttons > Secondary button text |
{{discount}} |
Inserts the discount value (percentage or amount) applied when a customer chooses a subscription frequency. | Save 15% when you subscribe monthly. |
| Text area > Text or Product > Percent savings text or Buttons > Primary button text or Buttons > Secondary button text |
{{items_count}} |
Displays the total number of items currently in the cart. | You have 3 items in your cart. |
Cart drawer variables
Use the following variables when building your Cart drawer flow:
Section |
Variable |
Description |
Example |
| Header > Cart title or Body > Cart items or Footer > Content |
{{discount}} |
Inserts the discount value (percentage or amount) applied when a customer chooses a subscription frequency. | Save 15% when you subscribe monthly. |
| Header > Cart title or Body > Cart items or Footer > Content |
{{items_count}} |
Displays the total number of items currently in the cart. | You have 3 items in your cart. |
Checkout Cross-Sell variables
Use the following variables when building your Checkout Cross-Sell flow:
Section |
Variable |
Description |
Example |
| Content | {{discount_percent}} |
Displays the discount percentage for subscription products with subscribe and save discounts. | Subscribe now and save 15%. |
Checkout Upsell All variables
Use the following variables when building your Checkout Upsell All flow:
Section |
Variable |
Description |
Example |
| Content | {{group_discount_amount}} |
Displays the calculated potential savings if the customer converts all eligible items in that group to subscriptions | Save $6.00 when you subscribe to all Coffee Bean products. |
| Content | {{total_discount_amount}} |
Displays the calculated potential savings if the customer converts all eligible items in the cart to subscriptions | Switch to subscription and save a total of $8.00 on your order. |
Checkout Upsell Line Items variables
Use the following variables when building your Checkout Line Items flow:
Section |
Variable |
Description |
Example |
| Content | {{discount_percent}} |
Displays the discount percentage for subscription products with subscribe and save discounts | Subscribe and save 15% on every order. |
| Content | {{onetime_amount}} |
Displays the price of the product with a one-time frequency | One-time purchase: $20.00. |
Post-Purchase Cross-Sell variables
Use the following variables when building your Post-Purchase Cross-Sell flow:
Section |
Variable |
Description |
Example |
| Content | {{product_title}} |
The title of the product selected to cross-sell on the post-purchase page. | Add Herbal Tea Sampler to your order. |
| Content | {{post_purchase_discount_percent}} |
The post-purchase discount configured in Recharge. Customers see the post-purchase discount whether you've chosen to combine it with a subscribe and save discount. Be sure to remove this field if your post-purchase discount is 0. | Get it now at 20% off. |
| Content | {{timer}} |
The time in minutes before the post-purchase offer expires. | Hurry, this offer expires in 10 minutes. |
| Content | {{total_amount}} |
The total amount the customer will pay to accept the post-purchase offer, including taxes and shipping. | Complete your order for just $25.99 (taxes and shipping included). |
Referrals variables
Use the following variables when building your Referrals flow:
Section |
Variable |
Description |
Example |
| Landing page > Friend's information form > Heading text | {discount_amount} |
Inserts the discount amount your friend will receive when they are referred by a customer. This variable automatically populates based on your referral program’s configuration. | Get 15% off their first order. |
| Landing page > Friend's information form > Heading text | {advocate_first_name} |
Inserts the first name of the customer who sent the referral. Use this variable to personalize the friend’s referral landing page. This variable only works with the landing page, not in notifications. | “Nicole invited you to try Recharge and enjoy a discount on your first subscription.” |
| Notification > Edit email body | {{customer.referral_url}} |
Inserts the unique referral link associated with the customer. Include this variable in your email templates to make it easy for customers to share their referral link with friends. | “Share your referral link to give friends 15% off: **https://yourstore.com/referral/nicole123**” |
Subscription widget variables
Use the following variables when building your subscription widget flow:
Section |
Variable |
Description |
Example |
| Labels and inputs > Frequency save | {discount} |
Inserts the discount value (percentage or amount) applied when a customer chooses a subscription frequency. | Save 15% when you subscribe monthly. |
| Badge > Badge Text | {maxDiscount} |
Displays the maximum available discount across all subscription frequencies. | Up to 25% off with subscription |
| Badge > Badge Text | {discount} |
Inserts the discount value (percentage or amount) applied when a customer chooses a subscription frequency. | Save 15% when you subscribe monthly. |
| Benefits and information > Static pricing | {discountPrice} |
Displays the discounted product price after applying the subscription discount. | Only $18.99 per order. |
| Benefits and information > Dynamic pricing | {initialDiscountAmount} |
Displays the discount amount applied to the first order only. | Get $5.00 off your first box. |
| Benefits and information > Dynamic pricing | {initialDiscountPercentage} |
Displays the discount percentage applied to the first order only. | Enjoy 20% off your first order |
| Benefits and information > Dynamic pricing | {recurringDiscountAmount} |
Displays the discount amount applied to each recurring order. | Save $3.00 on every renewal. |
| Benefits and information > Dynamic pricing | {recurringDiscountPercentage} |
Displays the discount percentage applied to each recurring order. | Enjoy 10% off every delivery. |
| Benefits and information > Dynamic pricing | {recurringDiscountCount} |
Displays the number of recurring orders the discount will apply to. | Discount applies for the first 3 orders |
| Benefits and information > Dynamic pricing | {recurringDiscountCountWithInterval} |
Displays how many orders and at what interval the discount applies. | Discount valid for 3 monthly orders. |
| Benefits and information > Benefits | {discount} |
Inserts the discount value (percentage or amount) applied when a customer chooses a subscription frequency. | Save 15% when you subscribe monthly. |
| Benefits and information > One-time drawbacks | {maxDiscount} |
Displays the maximum discount customers miss out on if they buy as a one-time purchase instead of subscribing. | You’ll miss out on 25% savings by ordering one-time. |
| Interval labels | {interval} |
Inserts the interval number (e.g., 1, 2, 3). | Deliver every 2 weeks. |
| Interval labels | {chargeInterval} |
Combines the interval number with the unit (day, week, month). | Charge every 3 months. |
| Interval labels | {unitPrice} |
Displays the price per unit when sold as part of a subscription. | Only $2.50 per bottle |
Upcoming order email variables
Use the following variables when building your Upcoming order email flow:
Section |
Variable |
Description |
Example |
| Landing page > Confirm delay > Heading | {date} |
Displays the original scheduled date of the customer’s next order before the delay is applied. | Your order was originally scheduled for September 20, 2025. |
| Landing page > Confirm delay > Description | {delay} |
Displays the length of time (in days, weeks, or months) that the order is being delayed. | Your delivery has been delayed by 2 weeks. |
| Landing page > Confirm delay > Description | {delayedDate} |
Displays the new scheduled date of the customer’s next order after applying the delay. | Your order will now ship on October 4, 2025. |
| Landing page > Confirm delay > Customize standard text | {interval} |
Displays the subscription interval number (e.g., 1, 2, 3). | Your subscription is delivered every 2 months. |
| Landing page > Confirm delay > Customize standard text | {unit} |
Displays the unit of time used in the subscription interval (days, weeks, months). | Your subscription renews every 1 month. |
| Landing page > Confirm delay > Customize standard text | {quantity} |
Displays the quantity of items in the subscription order. | You’re receiving 3 bags of coffee. |
| Landing page > Confirm delay > Customize standard text | {discount} |
Displays the discount applied to the subscription product. | You’re saving 15% on each order. |
| Landing page > Confirm delay > Customize standard text | {shipments} |
Displays the number of shipments in the subscription or the number of shipments that will be delayed. | This delay applies to your next 2 shipments. |
Win Backs variables
Use the following variables when building your Win Backs experience:
Section |
Variable |
Description |
Example |
| Landing page > Offer banner | {customer} |
Displays the customer’s name or identifier in the banner message. | Welcome back, Sammi |
| Landing page > Cart | {amount} |
Displays the total cart amount before checkout. | Your cart total is $45.00 |
| Landing page > Credits balance | {available_balance} |
Displays the customer’s available store credit balance. | You have $15.00 in credits |
| Landing page > Credits balance | {days_until_expiration} |
Displays the number of days until credits expire. | Your credits expire in 5 days |
| Landing page > Credits balance | {credit_expiration_date} |
Displays the expiration date for store credits. | Your credits expire on October 15, 2025 |
| Customize standard text | {count} |
Displays the count of items, orders, or shipments. | You have 4 items in your cart |
| Customize standard text | {quantity} |
Displays the quantity of items in the subscription order. | You’re receiving 3 bags of coffee. |
| Customize standard text | {savings} |
Displays the total savings amount applied. | You saved $10.00 today |
| Customize standard text | {product_title} |
Displays the product title. | Premium Coffee Beans |
| Customize standard text | {country} |
Displays the customer’s country. | Shipping to United States |
| Customize standard text | {query} |
Displays the customer’s search query. | Search results for protein powder |
| Customize standard text | {discount} |
Displays the discount applied to the order or product. | Subscription discount: 15% off |
| Customize standard text | {recurringTotal} |
Displays the recurring order total after discounts. | Your recurring total is $35.00 |
| Customize standard text | {interval} |
Displays the subscription interval value. | Delivered every 3 months |
| Customize standard text | {unit} |
Displays the time unit for the subscription interval. | Every 1 week |
| Customize standard text | {address} |
Displays the shipping address. | Shipping to 123 Main St, New York, NY 10001 |
Notification node variables
You can use the following variables when building your notifications using the Notification node:
Customer variables
Variable |
Description |
Works with the following templates |
{{customer.first_name}} |
Customer’s first name | |
{{customer.last_name}} |
Customer’s last name | |
{{customer.customer_portal_url}} |
Customer portal URL | |
|
|
A direct link to the customer portal payment methods page or payment methods landing page.
Note: If you use a custom customer portal as your URL, you can add the custom URL to your notifications. Recharge then switches the variable in your notifications from
{{customer.customer_portal_payment_methods_url}} to {{custom_portal_url}}. |
|
{{customer.total_credit_balance}} |
The customer's total credit balance | |
{{customer.credit_currency_code}} |
The currency code for credits (e.g. USD) | |
{{customer.clicked_referral_url}} |
CTA link to claim the offer |
Store variables
Variable |
Description |
Works with the following templates |
{{store.name}} |
Your store name |
Charge variables
Variable |
Description |
Works with the following templates |
{{charge.scheduled_at}} |
The scheduled date of the customer's next charge This is the charge associated with the flow |
|
{{charge.currency}} |
The currency of the customer's next charge This is the charge associated with the flow |
|
{{charge.line_items}} |
Array of products in the order. Each item includes:
|
|
{{charge.total_line_items_price}} |
The combined cost of all line items, calculated by multiplying each item’s price by its quantity, before any discounts are applied. | |
{{charge.note}} |
An optional message attached to a charge, typically added by the merchant or customer | |
{{charge.subtotal_price}} |
The total cost of all line items after product or percentage discounts are applied, but before shipping and taxes | |
{{charge.total_discounts}} |
Total discounts applied | |
{{charge.discounts}} |
A list of discount objects applied to the charge. Each discount includes the code, id, value, value_type (percentage or fixed_amount), title, and application_method. |
|
{{charge.total_duties}} |
Duties or import fees | |
{{charge.shipping_lines}} |
Array of shipping methods and prices | |
{{charge.total_price}} |
Final total | |
{{charge.total_tax}} |
Tax amount | |
{{charge.taxable}} |
Indicates whether the charge is subject to tax calculation. Returns true if the charge is taxable and false if it is tax-exempt. |
|
{{charge.tax_lines}} |
A list of tax line objects applied to the charge. Each tax line includes the title (tax name, for example, "Ohio State Tax"), rate (decimal tax rate, for example, 0.0575), and price (tax amount). |
|
{{charge.total_refunds}} |
The total amount refunded for the charge. Displays "0.00" if no refunds have been issued. | |
{{charge.shipping_address.address1}} {{charge.shipping_address.city}} {{charge.shipping_address.province}} {{charge.shipping_address.country_code}} {{charge.shipping_address.zip}}
|
The shipping address associated with the charge | |
{{charge.billing_address.address1}} {{charge.billing_address.city}} {{charge.billing_address.province}} {{charge.billing_address.country_code}} {{charge.billing_address.zip}}
|
The billing address associated with the charge | |
{{charge.error_type}} |
The error on the charge |
Product variables
Available only when cross_sell_products exists.
Variable |
Description |
Works with the following templates |
{{product.url}} |
Link to product page (Only used if |
|
{{product.image.large}} |
Product image URL. (Only used if |
|
{{product.product_title}} |
Product name (Only used if |
|
{{product.product_price}} |
Sale or current price (Only used if |
|
{{product.product_compare_at_price}} |
Original price (if discounted) (Only used if |
Delay option variables
Available only when delay_options exists.
Variable |
Description |
Works with the following templates |
{{delay_option.url}} |
Link to apply delay (Only used if |
|
{{delay_option.value}} |
Duration of delay (Only used if |
|
{{delay_option.unit}} |
Unit of time (e.g., “day”, “week”, or “custom”) (Only used if |
Offer variables
Variable |
Description |
Works with the following templates |
{{offer.product_title}} |
The title of the product used in an offer | |
{{offer.discounted_price}} |
The discounted price of the product used in an offer | |
{{offer.offer_value}} |
The value of the offer This could be a percentage or fixed value, depending on the offer type |
Credit variables
Variable |
Description |
Works with the following templates |
{{credit_details.credit_currency}} |
The currency code for credits (e.g. USD) | |
{{credit_details.credit_amount}} |
The credit amount the customer earned in credits | |
{{ credit_details.credit_amount | amount_with_currency(credit_details.credit_currency) }} |
The credit amount the customer earned in credits | |
{{ customer.total_credit_balance | amount_with_currency(credit_details.credit_currency) }} |
The customer's total credit balance |
Campaign variables
Variable |
Description |
Works with the following templates |
{{campaign.url}} |
This is the URL to the reactivation landing page. |
Failed Payment Recovery specific variables
Variable |
Description |
Works with the following templates |
{{custom_portal_url}} |
A direct link to your customer portal if you use a custom customer portal. | |
Variable |
Description |
Works with the following templates |
<h3>Items in Shipment</h3><table cellpadding="8px" style="border-collapse: collapse;">{% for item in charge.line_items %}<tr style="border-bottom: 1pt solid #CCC;"><td><img src="{{item.images['small']}}" width="60" height="60" style="border-radius: 8px"/></td><td><div><b>{{item.title}} x {{item.quantity}}</b></div>{% if item.variant and item.variant not in ("Default Title", "None", None) %} <div style="font-size:0.9rem;color:#444;">{{item.variant_title}}</div> {% endif %}</td></tr>{% endfor %}</table>
|
A list of line items included in the failed order | |
|
|
This code checks if a customer has store credits and, if so, displays a message warning customers that they will lose their credits if they cancel their subscription
|
Was this article helpful?
0 out of 0 found this helpful
