Notification Email Template Variables in EcoReturns
This article documents all dynamic variables available for use in email notification templates.
This article documents all dynamic variables available for use in email templates. These placeholders are automatically replaced with real data when an email is generated. Use them exactly as written, including the double curly braces.
1. Customer & Contact
| Variable | Description |
|---|---|
| {customer_name} | Customer’s name for the order/email |
| {customer_email} | Customer’s email address |
| {customer_phone} |
Customer’s phone number |
|
{custom_id} |
Customer platform identifier |
| {customer_address} | Full street address |
| {customer_city} | Customer city |
| {customer_state} | Customer state/province |
| {customer_state_code} |
State code |
| {customer_zip} | Postal/ZIP code |
| {country_name} | Country name |
| {country_code} | Country ISO code |
| {customer_upi_id} | Customer UPI ID |
2. Order Basics
| Variable | Description |
|---|---|
| {order_id} |
Platform order ID |
| {order_number} | Human-readable order number |
| {order_name} |
Human-readable order name |
| {ordid} |
Internal platform-specific ID |
| {ran} | Unique return request ID |
| {request_type} | Return / Exchange etc. |
| {order_fulfill_status} |
Original fulfillment status at the time of request submission |
| {status} |
Request status |
| {shipment_status} |
Shipment state |
3. Product & Line Item Information
| Variable | Description |
|---|---|
| {product_id} | Platform product ID |
| {line_item_id} | Line item ID |
| {name} | Product title |
| {product_title} | Alias of name |
| {sku} | SKU |
| {variants} |
Variant ID |
| {product_type} | Platform category |
| {product_category} | App category |
| {quantity} | Requested quantity |
| {new_item_quantity} | Exchange quantity |
|
{selected_product_for_exchange} |
Selected exchange product |
| {selected_variant_for_exchange} |
Exchange Variant ID |
|
{exchange_item_sku} |
Exchange SKU |
| {variant_name} | Variant name |
|
{uploaded_images} |
Images uploaded images by customer |
| {original_image} |
Original product image URL |
| {selected_variant_image} | Selected variant image |
4. Payment, Pricing & Refunds
| Variable | Description |
|---|---|
| {order_currency} | Order currency |
|
{order_total} |
Line total |
| {total_order_value} | Full order total |
| {item_purchase_price} | Per-item price |
| {item_discount} | Item discount |
| {order_discount} | Order discount |
| {tax_collected} | Tax amount |
| {shipment_fee} | Shipping cost |
| {additional_incentive} | Retention incentive |
|
{payment_refrence_id} |
Transaction reference |
|
{refund_to} |
Refund Method |
| {refund_status} | Refund status |
| {refund_amount} |
Refunded amount |
| {refund_adjust_amount_val} |
Adjusted refund amount when refunding manually |
|
{credit_amount} |
Amount to be refunded calculated at the time of request submission |
| {collected_amount} |
Payment collected from customer while returning items |
|
{reverse_shipment_fee} |
Reverse fee |
|
{reverse_shipment_fee_paid} |
Paid reverse fee by customer |
5. Bank / Payout Details
| Variable | Description |
|---|---|
| {account_number} | Customer bank account |
| {ifsc} | Bank IFSC |
| {beneficiary_name} | Account holder |
|
{payout_link} |
Payout page link |
6. Returns, Reasons & Exchange Context
| Variable | Description |
|---|---|
| {order_reason} | High-level reason |
| {reason_desc} | Customer comment |
| {sub_reason_detail} | Detailed reason |
| {sub_reason} | Alternate reason field |
| {return_reason} | Resolved reason name |
| {rejection_reason} | Rejection reason |
|
{allow_request_again} |
Request allowed again |
| {exchange_created} | Exchange created flag |
| {exchange_message} | Exchange message |
|
{exchange_order_id} |
Platform exchange ID |
| {exchange_order_number} | Display exchange number |
7. Shipping, Logistics & Tracking
| Variable | Description |
|---|---|
| {awb} | Tracking number |
| {courier} | Courier name |
|
{awb_tracking_link} |
Saved tracking link |
| {tracking_url} | Enriched tracking link |
|
{shipment_received_date} |
Received timestamp |
| {package_weight} | Weight |
| {package_weight_unit} | Weight unit |
| {package_height} | Height |
| {package_width} | Width |
| {package_length} | Length |
| {package_dimension_unit} | Dimension unit |
| {label_url} | Shipping label URL |
|
{amazonmcf_label_url} |
Amazon label |
| {reverse_shipment_payment_link} | Reverse payment link |
|
{shipping_label_payment_link} |
Label payment link |
8. Dates & Timeline
All datetime variables are pre-formatted strings (e.g. YYYY-MM-DD hh:mm AM/PM).
| Variable | Description |
|---|---|
| {crea_date} | Request creation date |
| {upda_date} | Last update |
| {exchange_created_date} | Exchange creation |
| {refunded_date} | Refund processed |
| {courier_assign_date} | Courier assigned |
| {forward_delivery_date} | Forward delivery |
| {pickup_date} | Pickup date |
| {delivery_date} | Delivery date |
| {intransit_date} | In-transit timestamp |
| {label_creation_date} | Label creation |
| {shipping_activity_initiated_date} | Shipping start |
| {payment_link_creation_date} | Payment link created |
|
{awb_attempt_timestamp} |
Last AWB attempt |
9. Store / Branding & Notification Metadata
| Variable | Description |
|---|---|
| {seller_name} | Store display name |
| {store_name} | Alias of seller_name |
| {store_url} | Store slug |
| {sender_email} | Sender email |
| {support_phone} | Support phone |
| {support_email} | Support email |
| {override_link} | Special resolution link |
|
{discount_coupon} |
Coupon code |
|
{gift_card_code} |
Gift card code |
10. Status, Flags & Miscellaneous
| Variable | Description |
|---|---|
| {is_archived} | Request archived |
| {is_closed} | Request closed |
| {received_status} | Item received |
| {received_condition} | Condition on receipt |
|
{awb_attempt_count} |
AWB attempts |
✔ Usage Tip:
If a variable has no value, it usually renders as empty.
To use these variables inside templates, they must be written in this exact format:
double brackets { {variable_name} } without spaces.