Custom Notifications - Variables

Avatar
SHOPLINE TW Copywriters

4. EC + SC (EN).png

To allow merchants to edit the system's default messages, SHOPLINE provides the "Custom Notification" feature, which enables editors to add text, images, and links to the notification emails and SMS to provide customers with more customized, relevant information. This article will go over copying and adding variables to the custom notification templates.

*Note: Before you start editing, please confirm whether your plan can use the "Customize Notification" application. To enable the SMS feature, please contact our Online Merchant Success Team.

For operation details and procedures, please refer to the two FAQ articles below:

 

In this article, you'll find:

 

1. List of Variables

The following are the variables that can be used in each notification. Please use "Control + F" (Windows) or "Command + F" (iOS) to find the keyword more efficiently.

*Note: It is recommended to use variables for URLs. The system will automatically convert them into compliant short URLs. If you use other short URLs, telecom providers might flag them as sensitive or suspicious, which could result in blocked SMS delivery.

 

i. Variables for member notifications

Member Notifications Variable Description
 Common variables for member  notifications

 {{shop.name}}

 {{customer.name}}

 {{notification.url}}

 Your shop's name

 Customer's name

 Shop shorten URL
 Member Account Setup/Import  Notification  {{notification.url}}  Setup password URL
 Membership Upgrade  Notification

 {{customer.tier.name}}

 {{customer.tier.member_discount}}

 Customer's membership tier

 Customer's membership tier  discount
Upcoming Membership Downgrade Notification

{{customer.tier.name}}

{{customer.tier.end_at}}

{{customer.tier.extend_gap}}

Membership tier

Membership expiration date

Amount needed for renewal
Membership Downgrade Notification

{{customer.tier.name}}

{{customer.tier.member_discount}}

Membership tier

Membership tier discount
 Assign Store Credits Notification

 {{store_credit.value}}

 {{store_credit.credit_balance}}

 {{store_credit.end_at}}

 {{store_credit.remarks}}

 {{shop.cart_url}}

 Assign store credit amount

 Customer's store credit balance

 Store credit expiration date

 Store credit remarks

 Shopping cart link
 Store Credit Expired Notification

 {{expiry_credit_amount}}

 {{store_credit.end_at}}

 {{store_credit.remarks}}

 {{shop.cart_url}}

 Stores credit amount to expire

 Store credit expiration date

 Store credit remarks

 Shopping cart link
 Welcome Credits Notification

 {{store_credit.value}}

 {{store_credit.credit_balance}}

 {{store_credit.end_at}}

 {{store_credit.remarks}}

 {{shop.cart_url}}

 Welcome credit amount

 Customer credit balance

 Store credit expiration date

 Store credit remarks

 Shopping cart link
 Birthday Credits Notification

 {{store_credit.value}}

 {{store_credit.credit_balance}}

 {{store_credit.end_at}}

 {{store_credit.remarks}}

 {{shop.cart_url}}

 Birthday credit amount

 Customer credit balance

 Store credit expiration date

 Store credit remarks

 Shopping cart link
 Order Reward Credits  Notification

 {{store_credit.value}}

 {{store_credit.credit_balance}}

 {{store_credit.end_at}}

 {{store_credit.remarks}}

 {{shop.cart_url}}

 Order reward credit amount

 Customer credit balance

 Store credit expiration date

 Store credit remarks

 Shopping cart link

 Member Referral Notification

 (to Referrer)

 {{customer.name}}

 {{store_credit.value}}

 Referrer's name

 Referrer reward credit to be  assigned to referrer after new  member placed an order

 Member Referral Notification 

 (to New member)

 {{customer.name}}

 {{store_credit.value}}

 New member's name

 Member referral credit amount

 Referrer Reward Notification 

 (to Referrer)

 {{customer.name}}

 {{store_credit.value}}

 {{store_credit.credit_balance}}

 Referrer's name

 Referrer reward credit

 Customer credit balance
 Assign Member Points  Notification

 {{member_point.value}}

 {{member_point.point_balance}}

 {{member_point.end_at}}

 {{member_point.remarks}}

 {{shop.cart_url}}

 Assigned member point amount

 Customer member point balance

 Member point expiration date

 Member point remarks

 Shopping cart link
Point Expiration Notification

{{expiry_point_amount}}

{{member_point.end_at}}

{{member_point.remarks}}

{{shop.cart_url}}

Member point amount to expire

Member point expiration date

Member point remarks

Shopping cart link
 Earn Points Notification

 {{member_point.value}}

 {{member_point.point_balance}}

 {{member_point.end_at}}

 {{member_point.remarks}}

 {{shop.cart_url}}

 Accumulated order reward  points

 Customer point balance

 Member point expiration date

 Member point remarks

 Shopping cart link
Send Coupon Notification

 {{promotion.title}}

 {{promotion.start_at}}

 {{promotion.end_at}}

 {{promotion.available_platforms}}

 {{shop.cart_url}}

 Promotion Name

 Start date of promotion

 End date of promotion

 Promotion applicable platform

 Shopping cart link
Coupon Valid Notification

{{promotion.title}}

{{promotion.start_at}}

{{promotion.end_at}}

 {{promotion.available_platforms}}

 {{shop.cart_url}}

Promotion Name

Start date of promotion

End date of promotion

Promotion applicable platform

Shopping cart link

 

 Coupon Expire Notification

 

 {{promotion.title}} 

 {{promotion.start_at}}

 {{promotion.end_at}}

 Promotion Name

 Start date of promotion

 End date of promotion

*Note: If the expiry date for store credits or member points is set to never expire, the system will display it as "None".

 

ii. Variables for order notifications

Member Notifications Variable Description
Common variables for order notification {{shop.name}} Your shop's name
{{order.seller.email}} Your shop's email
{{notification.url}} Shop shorten URL
Customer related  {{customer.name}} Customer’s name
{{customer.email}} Customer’s email
{{customer.phone | mask: phone}} Customer’s phone number (3 middle digits masked)
{{customer.gender}} Customer’s gender
{{customer.birthday | date: "%b %d, %Y"}} Customer’s birthday

{{customer.attributes}}

{{attribute | first}}

{{attribute | last}}

 Customer’s custom fields
Order related {{order.customer_url}} Order URL
{{order.status_label}} Order status
{{order.remarks}} Order remarks

{{customer.attributes}}

{{attribute | first}}

{{attribute | last}}

 Order custom fields
{{order.payment_slip_url}} Pay and upload payment slips
{{order.created_at | date: "%Y-%m-%d %H:%M%p"}} Order date
{{order.order_number}} Order number
Payment related {{order.subtotal_price}} Subtotal
{{order.discount_price}} Discount
{{order.custom_discount_price}} Custom discount total amount
{{order.applied_user_credit}} Applied store credits
{{order.redeemed_points_to_cash}} Member points redeemed for cash
{{order.redeemed_points_to_cash_amount}} Applied point discount
{{order.delivery_fee}} Delivery fee
{{order.exclusive_tax.fee}} Tax fee
{{order.total_price}} Total price

{{order.inclusive_tax}}

{{order.inclusive_tax.name}}

{{order.inclusive_tax.rate}}

{{order.inclusive_tax.fee}}

 Tax included
{{order.earned_credit_value}} Credits earned after paid
{{order.redeemed_points_to_gift}} Points used to redeem gifts

{{order.earned_points_pending_days}}

{{order.earned_points}}

 Point Assign Day
{{order.order_payment.status_label}} Payment status
{{order.order_payment.name}} Payment option
{{order.order_payment.instructions}} Payment instructions

{{order.order_payment.instruction_image}}

{{order.order_payment.instruction_image.src | img_url: '750x'}}

{{order.order_payment.instruction_image | img_url: '750x'}}

 Payment instruction image
{{order.order_payment.txn_id}} PayPal transaction ID
{{order.order_payment.type}} Payment type
{{order.order_payment.transaction_id}} Transaction ID
{{order.order_payment.fee}} Payment fee
{{order.subtotal_price}} Subtotal
{{order.discount_price}} Discount
Delivery related

{{order.order_delivery.status_label}}

{{order.order_delivery.name}}

{{order.delivery_date}}

{{order.delivery_time_slot}}

{{order.order_delivery.description}}

{{order.order_delivery.address.address.address1}}

{{order.order_delivery.address.address.address2}}

{{order.order_delivery.address.address.city}}

{{order.order_delivery.address.address.state}}

{{order.order_delivery.address.address.country}}

{{order.order_delivery.address.address.postcode }}

{{order.order_delivery.recipient_name}}

{{order.order_delivery.recipient_phone}}

{{order.order_delivery.location_code}}

{{order.order_delivery.location_name}}

{{order.order_delivery.delivery_name_title}}

{{order.order_delivery.delivery_name}}

{{order.order_delivery.tracking_number}}

{{order.order_delivery.url}}

{{order.order_delivery.shipment_number}}

{{order.order_delivery.sn_id}}

{{line_item.catcher_delivery_status}}

Delivery status

Delivery option

Delivery date

Delivery description

Address

Recipient name

Recipient phone number

Pick Up store code

Pick Up store name

Courier company name (as a title)

Courier company name/HOP! Address/ SF Express address

Tracking number

Delivery tracking URL

Shipment number

Shop-to-Shop delivery ID

Delivery status from the manufacturer
Product related

{{order.line_items}}

{{line_item.image_url}}

{{line_item.title}}

{{line_item.type}}

{{line_item.variation_names}}

{{name}} for loop

{{line_item.child_products}}

{{child_product.title}}

{{child_product.variation_names}}

{{line_item.quantity}}

{{line_item.item_points}}

{{line_item.price}}

{{line_item.preorder_note}}

{{line_item.total_points}}

{{line_item.total_price}}

Order items

Product image

Product name

Product type

Variation name

Bundled product

Bundled product name

Bundled product variation name

Product quantity

Number of points redeemed for product

Product price

Preorder product notice

Total points

Total price

Subscription order related

 

{{product_subscription.next_billing_at}}

{{subscription_product.title}}

{{product_subscription.recurring_count}}

{{product_subscription.next_recurring_count}}

{{product_subscription.duration}}

{{product_subscription.recurring_count_limit}}

Next order creation time

Subscription product 

Subscription

Number of subscription 

Subscription cycle

Subscription limit 
Split order related {{order.parent_order_number}} New Order (Split Order) number has been created 

 

2. Lists of variables for 11 custom notifications

  • Payment Slip Upload Notification, Order Message Notification, Email Verification Notification, Mobile Verification Notification, Shop Message Notification, Abandoned Cart Notification, and Back in Stock Notification - Click here
  • Variables for Order Canceled Notification, SHOPLINE Payments Refund Notification - Click here

  • Customer Return Order Request Notification, Returned Order Status Update Notification - Click here

 

3. Notes

  • If you have enabled the feature to send SMS, SHOPLINE will charge a monthly fee for the SMS.
  • The sample character count of the email subject and SMS message is only for reference and does not serve as the final number of characters. The number is subjected to the text converted from the variables, e.g. {{store_credit.credit_balance}}.  
  • The "Send Order Status Update SMS Notifications" toggle button has been removed from the Order Settings page. To enable or disable the SMS notification feature, go to the Custom Notification edit page.
    Screen_Shot_2021-11-03_at_4.20.28_PM.png
  • The variable and URL shown in the preview is a sample of how the variables will be converted. Please refer to the list of variables for editing the actual message content.
  • The system does not yet support multi-language translation. If you enter English content in the Traditional Chinese tab, the customer who has set to receive messages in Traditional Chinese will receive the text content in English. Please be sure to confirm the language tab when editing.
  • The system will determine the language of the notification received by the customer according to the customer's login status and whether the store language has been modified:
    • The customer has not logged in and has not switched the store language: Default Shop Language (based on customer's browser language or merchant's custom choice)
    • The customer has not logged in and has switched the store language: The store language most recently switched by the customer.
    • The customer has logged in and has not switched the store language: Customer's browser language
    • The customer has logged in and has switched the store language: The store language most recently switched by the customer.

 

 

Read more

 

 

 

 

 

Have more questions? Submit a request

Comments