Understanding Dynamic Sources in Email Notification Templates
Dynamic sources are placeholders in your notification email templates that automatically pull in real details — such as a customer's name, an order number, or a tracking number — when an email is sent. They let you personalize automated emails like order confirmations and shipping updates without manually editing every message. The old and new versions of the Mail Editor support different sets of dynamic sources. This guide explains how preview and test emails display dynamic sources, where to find the built-in dynamic source guide inside the Mail Editor, and which dynamic sources are available in each editor version.
How Preview and Test Emails Display Dynamic Sources
When you're editing a notification template, the editor preview and any test emails you send show sample data for each dynamic source — for example, a sample order number or a sample tracking number — instead of a real customer's information.
This lets you check how a template will look without waiting for a real order or customer action to trigger it.
| Note: Preview and test emails only display sample data. When an email is actually sent to a customer, all dynamic sources are automatically replaced with real information. |
Finding the Dynamic Source Guide in the Mail Editor
Both the old and new versions of the Mail Editor include a built-in guide that explains what each dynamic source means, so you don't have to guess before adding one to a template.
To view the dynamic source guide:
- From your SHOPLINE admin panel, go to Settings > Notifications.
- Click the name of the notification scenario you want to edit (for example, Order Confirmation) to open the Mail Editor.
- In the component you're editing, click Add dynamic source to open the dynamic source panel.
- Click Dynamic source guide (shown near the mock value field) to view the list of dynamic source names and what each one means.
| Note: The old and new Mail Editor don't support the same dynamic sources. If you insert a dynamic source that isn't available in the editor version you're using, it won't display correctly. Check the Available In column below, or the in-editor dynamic source guide, before adding one to your template. |
Dynamic Source Glossary
The table below lists the dynamic sources currently available in the Mail Editor, grouped by category, along with what each one means and which editor version supports it.
Store and Customer Basics
| Dynamic Source | What It Means | Available In |
| Store Name | The name of your store as shown to customers. | Old & New |
| Store Domain | The web address customers use to visit your store. | New Only |
| Customer Name | The name of the individual registered to the store account. | Old & New |
| Store Logo | The image representing your store's brand. | New Only |
| Customer Service Email | The email address used to receive customer inquiries and handle after-sales issues. | Old & New |
| Unsubscribe Link | The link customers use to cancel their email subscription. | New Only |
Order and Fulfillment Details
| Dynamic Source | What It Means | Available In |
| Online Store Address | The web address of your online store. | New Only |
| Order Number | The order number assigned by your store. | Old & New |
| Order Details Link | The link to the customer's order details page. | New Only |
| Password Reset Demo | Sample content used to demonstrate the forgot-password flow. | Old & New |
| Pickup Location | The address where the customer can pick up their order in-store. | New Only |
| Payment Method | The payment channel the customer used to pay. | New Only |
| Shipping Address | The address the customer provided for delivery. | New Only |
| Delivery Method | The fulfillment method used (e.g., courier delivery, in-store pickup). | New Only |
| Receiver Name | The name of the person receiving the order. | New Only |
| Customer Note | Additional instructions the customer added when placing the order (e.g., delivery instructions). | New Only |
| Billing Address | The address the customer provided for payment verification and billing records. | New Only |
| Tracking Number | The unique number used to track a shipment with the carrier. | Old & New |
| Courier and Tracking Number | The combined carrier name and tracking number. | New Only |
| Payment Method Type | The payment method used to complete the order (e.g., credit card, PayPal, cash on delivery). | New Only |
| Checkout Link | The link that takes the customer to complete payment on an unpaid order. | New Only |
| Repayment Link | The link that lets a customer retry payment after a failed transaction. | New Only |
| Order Payment Due Date | The final date by which a billing-based order (e.g., installment or pay-later) must be paid. | New Only |
| Order Payment Method and Time | The combined payment method and time an order payment was completed, used in payment confirmation emails. | New Only |
| Seller Order Details Link | The link in your admin panel to view and manage a specific order. | New Only |
| System Order Number | The unique number automatically generated for each order, used for order lookups, after-sales service, and reconciliation. | New Only |
| New Account Order Details Link | The order details link for customers using the new customer account system. | New Only |
| Logistics Info List | The combined carrier name, code, and website link for a shipment. | New Only |
| Receiver First Name | The customer's first name (only valid when first and last names are stored separately). | New Only |
| Receiver Last Name | The customer's last name (only valid when first and last names are stored separately). | New Only |
Payments and Refunds
| Dynamic Source | What It Means | Available In |
| Refund Amount | The amount refunded to the customer, typically shown in refund notification emails. | Old & New |
| Refund Success Time | The date and time a refund was completed, used to notify the customer. | New Only |
| Refund Method | How the refund was issued (e.g., original payment method, store credit, gift card). | New Only |
| Refund Channel | The payment channel the refund was processed through (e.g., the original card or PayPal account). | New Only |
| Remaining Balance Due | The amount a customer still owes on an order, used for payment reminders. | New Only |
| Return Order Number | The original order number linked to a return request, used for after-sales tracking and reconciliation. | Old & New |
| Refund Failure Reason | The reason a refund could not be completed (e.g., channel limits, account issues). | New Only |
| Return Rejection Note | The reason a merchant provides when declining a customer's return request. | New Only |
Marketing and Promotions
| Dynamic Source | What It Means | Available In |
| Marketing Banner Title | The main heading of a promotional banner in an email or on a page. | New Only |
| Marketing Banner Content | The supporting text for a promotional banner, describing the offer, rules, or timing. | New Only |
| Discount Code | A discount code created through a social commerce channel. | New Only |
Customer Subscriptions and Account
| Dynamic Source | What It Means | Available In |
| Unsubscribe Token | The identifier included in a customer's unsubscribe link. | New Only |
| Customer Email | The customer's email address. | New Only |
| Subscription Confirmation Link | The link a customer uses to confirm their email subscription. | New Only |
| Resubscribe Link | The link a customer uses to resubscribe after unsubscribing. | New Only |
| Update Payment Method Link | The link a customer uses to update their payment method. | New Only |
Gift Cards
| Dynamic Source | What It Means | Available In |
| Gift Card Amount | The value of the gift card. | New Only |
| Gift Card Currency | The currency the gift card is issued in. | New Only |
| Gift Card Short Link | The shortened link used to access a gift card. | New Only |
| Gift Card Image | The cover image for the gift card's design. | New Only |
| Recipient Email | The email address of the gift card recipient, used to send the gift card. | New Only |
| Recipient Nickname | The display nickname of the gift card recipient. | New Only |
| Recipient Name | The full name of the gift card recipient. | New Only |
| Gift Message | The personal message the purchaser leaves for the recipient. | New Only |