Skip to main content

Subi Notification Variables Reference

Learn about the variables you can use to customize your Subi email notification templates.

Overview

In Subi, you can enable various email notifications to keep both you and your customers informed about their subscriptions and memberships. You can customize these email notifications using HTML coding and variables.


How to Access and Edit Notification Templates

To access and edit your notification templates, navigate to Subi app > Settings > Notifications. Click on the three dots next to the email notification you want to modify and select "Edit Code".

Subi logo

Notification Variables

Variables allow you to dynamically insert subscription and customer data into your email notifications. For example, you can include details such as the customer’s email, subscription contract ID, product name, and more.

The table below lists the available variables and their descriptions. These variables can be used in your HTML code when editing email templates.

Note that not all variables are available for every notification template, so be sure to check the descriptions for availability.

Available Notification Variables:

Variable

Description

contract.id

Subscription contract ID

contract.frequency

Subscription frequency (e.g., "Every 2 months", "Every 1 week", "Every 2 days")

contract.page_link

URL to the subscription contract details page (e.g., "hengamproducts.myshopify.com/admin/apps/subi/subscriptions/123")

contract.subtotal_price_with_currency

In the new subscription emails (to the customer and to you): the price of the subscription’s items on the first order, before any discount (e.g., "$50.00"). In other emails: the subscription’s total.

Note: Not available for Payment Failure emails.

contract.subtotal_price_amount

The same amount as a number (e.g., 50).

Note: Not available for Payment Failure emails.

contract.created_at

Subscription creation date (e.g., "Aug 4, 2024")

contract.coupon_discount_with_currency

In the new subscription emails (to the customer and to you): this subscription’s share of a discount code used on the first order (e.g., "$4.00"). Empty when no code was used.

Note: Not available for Payment Failure emails.

contract.coupon_discount_amount

The same amount as a number (e.g., 4); empty when no code was used.

Note: Not available for Payment Failure emails.

contract.total_price_amount

Total subscription price after discounts, as a number (e.g., 36). In the new subscription emails it is the first order’s total for this subscription; in the billing reminder and payment failure emails, the total of that order, including any one-time product added to it.

contract.total_price_with_currency

The same total, formatted (e.g., "$36.00"). See "How amounts are written" below.

contract.subscription_discount_with_currency

In the new subscription emails (to the customer and to you): the subscription discount on the first order (e.g., "$10.00"), including a box, bundle or volume discount. Empty when there is none.

contract.subscription_discount_label

In the new subscription emails (to the customer and to you): the name of a box, bundle or volume discount, when that is the subscription discount.

contract.coupon_code

In the new subscription emails (to the customer and to you): the discount code used on the first order (e.g., "WELCOME10"). Empty when none.

contract.other_discount_with_currency

In the new subscription emails (to the customer and to you): any other automatic discount on the first order. Empty when none.

contract.other_discount_label

In the new subscription emails (to the customer and to you): the name of that other discount, as the order confirmation shows it.

contract.coupon_applies_to_first_order_only

In the new subscription emails (to the customer and to you): True when the discount code applied only to the first order.

contract.later_order_total_with_currency

In the new subscription emails (to the customer and to you): the price of each later order (e.g., "$40.00").

contract.price_block_is_next_order

In the new subscription emails (to the customer and to you): True when the subscription has no first order to read, so the amounts are those of its next order.

contract.order_name

In the new subscription emails (to the customer and to you): the first order’s number (e.g., "#1042").

contract.next_billing_month_day

In the new subscription emails (to the customer and to you): the next order’s date as month and day (e.g., "Nov 22").

contract.subscription_items_with_currency

Billing reminder only: the price of the subscription’s items on the upcoming order, before discounts (e.g., "$50.00").

contract.subscription_line_count

Billing reminder only: how many subscription products the upcoming order has.

contract.one_time_items_with_currency

Billing reminder only: the price of one-time products the customer added to the upcoming order (e.g., "$8.00"). Empty when none.

contract.order_discount_with_currency

Billing reminder only: the upcoming order’s discount (e.g., "$10.00"). Empty when none.

contract.order_discount_is_subscription_only

Billing reminder only: True when that discount is the subscription discount alone.

contract.lines

A list of line items in the subscription contract. In the billing reminder and payment failure emails it also lists one-time products the customer added to that order. Example:

{% for line in contract.lines %}

{{ line.product_title }} ({{ line.discount }}) : {{ line.price_with_currency }}

{% endfor %}

contract.line.product_title

The name of the product in the subscription contract

contract.line.variant_title

The variant of the product (e.g., "Medium")

contract.line.quantity

Quantity of the product in the subscription contract

contract.line.price_amount

Price of the subscription contract line (e.g., 40). In the new subscription emails, the line’s price on the first order.

contract.line.price_with_currency

The same price, formatted (e.g., "$40.00").

contract.line.discount

Discount applied to the contract line (e.g., "%20", "$100 USD", "$5 USD", "%5")

contract.line.base_price_with_currency

The line’s unit price before the subscription discount (e.g., "$50.00"); line.base_price_amount is the same as a number.

contract.line.base_total_with_currency

The line’s price before the subscription discount, times its quantity (e.g., "$100.00" for 2 × $50.00).

contract.line.is_one_time

Billing reminder and payment failure emails: True for a one-time product the customer added to that order only.

shop.name

The name of the shop

shop.logo

The shop logo

shop.email

The shop email

shop.merchant_name

The merchant’s name

shop.domain

The domain of the shop (e.g., "hengam-shop.com")

shop.shopify_domain

The Shopify domain of the shop (e.g., "hengam.myshopify.com")

shop.address

The shop’s address (street, city, province).

shop.notification_settings_url

The link to the Notifications settings page in Subi.

subify_email

The Subi email used for communications (e.g., "[email protected]")

portal_link

The link to the customer’s portal. In emails sent to the customer when your emails link to the Subi portal, it opens that customer’s subscription already logged in, for 3 days after sending; in test emails and in emails to you, it is the portal’s login page. When your emails link to the Shopify customer account, it is that account’s address.

customer.name

The customer’s name

customer.first_name

The customer’s first name

customer.email

The customer’s email

billing.payment_failure_reason

Reason for payment failure (e.g., "Your card was declined").

Note: Only available for Payment Failure emails.

billing_settings.dunning_enabled

Indicates if dunning (retrying failed payments) is enabled (True/False).

Note: Not available for Subscription Activation and Cancellation emails.


How amounts are written

Every amount prints in the subscription’s own currency. When that is your shop’s currency, it follows your shop’s price format (e.g., "$29.90"). When the customer subscribed in another currency, it shows the symbol and the currency code (e.g., "€29.90 EUR"). Currencies without decimals,, such as the Japanese yen, print without decimals.

If you saved your own template, it keeps its layout and these variables print the corrected amounts.

Need Help?

Feel free to contact our support team. We're here for you anytime:

  • Live Chat: Message us from within the Subi app or your Shopify Admin.

  • Email: Reach us at [email protected].

Did this answer your question?