Skip to content

Billing and orders

Shipping confirmation email template.

Tell a customer their order is on its way, with the carrier, tracking link and what is in the parcel.

Look

SubjectYour order #10482 is on its way

PreviewTrack your package with DHL.

Shown inApple Mail and iPhone Mail switch automatically

The preview uses example data, so no real names or numbers. Mail programs differ: send one to your own inbox before you rely on it.

When to send it

When the order leaves you. It is the email people open to find the tracking link, so put the link first.

Get it right

  • Put the tracking button near the top and the carrier and number below it for anyone who needs to copy them.
  • Give an estimated delivery date, and call it an estimate.
  • List what is in the shipment. If it is split across parcels, say which items are in this one.
  • Send the next email, delivered, from the same template with a different heading.

Use it in Mailtruss

Choose New template, pick Order shipped, change the words and colours, and publish. 3,000 emails a month are free, with no credit card.

Variables

Wrap a name in double braces and Mailtruss fills it in when you send. A value after a bar is the fallback when you leave it out, such as {{first_name | there}}. Values are escaped, so a name with markup in it cannot break the message.

VariableWhat it isExampleNeeded?
app_nameYour product or company name.AcmeYes
first_nameThe person's first name. Optional; the email says "there" without it.AnaOptional
order_numberYour order reference.#10482Yes
carrierThe delivery company.DHLYes
tracking_numberThe carrier's tracking number.JD014600006281Yes
tracking_urlThe carrier's tracking page for this parcel.https://tracking.example.com/JD014600006281Yes
estimated_deliveryThe expected delivery date or range. Optional.19 to 21 NovemberOptional
itemsWhat is in this shipment, a list. Each has a description and a quantity.a list of 2: Ceramic mug, white, Tea samplerYes
footer_textThe small print at the bottom, such as your company name and postal address. Optional: a short note about why the person got this email is used when you leave it out.Acme Inc, 1 Main Street, SpringfieldOptional

Create it and send it

Create the template from this starter with one request (or from the dashboard), then send it by its alias with your values. Only the published version is ever sent. Other languages are on send email by language.

Create the template
curl -X POST https://mailtruss.com/api/v1/templates \
-H "Authorization: Bearer $MAILTRUSS_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "starter": "shipping-update", "look": "mint", "alias": "shipping-update", "publish": true }'
send.ts
import { MailClient } from "mailtruss";
​
const mail = new MailClient({ apiKey: process.env.MAILTRUSS_API_KEY! });
​
await mail.emails.send(
{
from: "Acme <hello@yourdomain.com>",
to: "person@example.com",
template: {
id: "shipping-update", // the alias you gave the template
variables: {
app_name: "Acme",
order_number: "#10482",
carrier: "DHL",
tracking_number: "JD014600006281",
tracking_url: "https://tracking.example.com/JD014600006281",
items: [{"description":"Ceramic mug, white","quantity":"2"},{"description":"Tea sampler","quantity":"1"}],
},
},
},
{ idempotencyKey: "shipping-update-<your-event-id>" }, // makes retries safe
);

A list such as items repeats its rows once for each entry, up to 100. Each entry is an object with the fields shown in the example. The sending guide has the full rules.

The HTML and the text

This is exactly what the starter produces. Copy it into any system that sends HTML, or use it in Mailtruss to keep editing visually.

shipping-update.html
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="color-scheme" content="light dark">
<meta name="supported-color-schemes" content="light dark">
<style>@media only screen and (max-width:520px){.mt-card{width:100%!important;border-radius:0!important}.mt-px{padding-left:22px!important;padding-right:22px!important}.mt-col{display:block!important;width:100%!important;padding:0 0 18px 0!important}.mt-hero,.mt-section{padding:24px 20px!important}.mt-title{font-size:26px!important}}@media (prefers-color-scheme:dark){.mt-pagebg,.mt-page{background:#0e0f12!important}.mt-card{background:#17181c!important;border-color:#2b2d34!important}.mt-title,.mt-subtitle,.mt-heading,.mt-value,.mt-quote{color:#f1f1f4!important}.mt-text,.mt-li,.mt-list{color:#cfd0d8!important}.mt-label,.mt-small,.mt-footer,.mt-unsub,.mt-footer a{color:#9b9da8!important}.mt-rule{border-color:#2b2d34!important}.mt-tone-tint,.mt-tone-card{background:#21232a!important;border-color:#2b2d34!important}.mt-tone-tint .mt-title,.mt-tone-card .mt-title{color:#f1f1f4!important}.mt-code,.mt-codeblock,.mt-linkbox{background:#111216!important;color:#f1f1f4!important}.mt-inline-code{background:#21232a!important;color:#f1f1f4!important}.mt-link{color:#30967e!important}.mt-brandtext{color:#30967e!important}.mt-btncell{background:#0b8467!important;border-color:#0b8467!important}.mt-button{color:#ffffff!important}.mt-ghost{background:transparent!important;border-color:#30967e!important}.mt-ghost .mt-button{color:#30967e!important}.mt-badge-neutral{background:#21232a!important;color:#f1f1f4!important}.mt-mark,.mt-stepnum{background:#0b8467!important;color:#ffffff!important}.mt-markdot{background:#ffffff!important}.mt-tone-accent,.mt-tone-dark{border:1px solid #2b2d34!important}.mt-co-info{background:#1f2b44!important;color:#c8d7f3!important}.mt-co-success{background:#192f23!important;color:#c0dbc8!important}.mt-co-warning{background:#3a2d1d!important;color:#ebd9c0!important}.mt-co-danger{background:#3c1e1f!important;color:#edc6c4!important}}</style>
</head>
<body class="mt-page" style="margin:0;padding:0;background:#e4f4ee">
<div style="display:none;max-height:0;overflow:hidden;opacity:0;color:transparent;mso-hide:all">Track your package with {{carrier | the carrier}}.&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;</div>
<table class="mt-pagebg" role="presentation" width="100%" cellpadding="0" cellspacing="0" style="background:#e4f4ee">
<tr>
<td align="center" style="padding:32px 12px">
<table class="mt-card" role="presentation" width="600" cellpadding="0" cellspacing="0" style="width:100%;max-width:600px;background:#ffffff;border-radius:24px;border-collapse:separate">
<tr>
<td style="height:34px;line-height:1px;font-size:1px">&nbsp;</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 40px 22px">
<table role="presentation" cellpadding="0" cellspacing="0" border="0" >
<tr>
<td style="padding:0 10px 0 0;vertical-align:middle">
<table role="presentation" cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="mt-mark" width="30" height="30" align="center" valign="middle" style="width:30px;height:30px;background:#0b8467;border-radius:15px">
<table role="presentation" cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="mt-markdot" width="10" height="10" style="width:10px;height:10px;line-height:10px;font-size:1px;background:#ffffff;border-radius:50%">&nbsp;</td>
</tr>
</table>
</td>
</tr>
</table>
</td>
<td class="mt-brandtext" style="vertical-align:middle;font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:17px;font-weight:700;letter-spacing:-0.2px;color:#0b8467">{{app_name | Your app}}</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 40px 22px">
<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="border-collapse:separate">
<tr>
<td class="mt-hero mt-tone-tint" style="background:#eef6f4;border-radius:22px;padding:34px 30px;text-align:left">
<div class="mt-eyebrow" style="font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:12px;font-weight:700;letter-spacing:1.4px;text-transform:uppercase;color:#637672;margin:0 0 12px">Shipped</div>
<h1 class="mt-title" style="margin:0;font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:32px;font-weight:700;line-height:116%;letter-spacing:-0.6px;text-decoration:none;color:#12302a;text-align:left">Your order is on its way</h1>
<p class="mt-text" style="margin:12px 0 0;font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:16px;font-weight:400;line-height:165%;letter-spacing:0px;text-decoration:none;color:#637672;text-align:left">Hi {{first_name | there}}, order {{order_number}} has shipped.</p>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 40px 20px">
<table role="presentation" cellpadding="0" cellspacing="0" border="0" style="border-collapse:separate;">
<tr>
<td class="mt-btncell" align="center" bgcolor="#0b8467" style="background:#0b8467;border-radius:40px;">
<a class="mt-button" href="{{tracking_url}}" style="display:inline-block;padding:14px 30px;font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:15px;font-weight:650;line-height:100%;letter-spacing:0px;color:#ffffff;text-decoration:none;text-align:center;border-radius:40px">Track package</a>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 40px 6px">
<table class="mt-columns" role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="mt-col" width="50%" valign="top" style="padding:0 10px 0 0px">
<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="mt-px" style="padding:0px 0px 22px">
<div class="mt-stat" style="text-align:left;font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif">
<div class="mt-label" style="font-size:12px;font-weight:600;letter-spacing:1.2px;text-transform:uppercase;color:#637672">Carrier</div>
<div class="mt-value" style="margin:4px 0 0;font-size:30px;font-weight:700;line-height:118%;letter-spacing:-0.8px;color:#12302a">{{carrier}}</div>
</div>
</td>
</tr>
</table>
</td>
<td class="mt-col" width="50%" valign="top" style="padding:0 0px 0 10px">
<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="mt-px" style="padding:0px 0px 22px">
<div class="mt-stat" style="text-align:left;font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif">
<div class="mt-label" style="font-size:12px;font-weight:600;letter-spacing:1.2px;text-transform:uppercase;color:#637672">Estimated delivery</div>
<div class="mt-value" style="margin:4px 0 0;font-size:30px;font-weight:700;line-height:118%;letter-spacing:-0.8px;color:#12302a">{{estimated_delivery | Soon}}</div>
</div>
</td>
</tr>
</table>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 40px 14px">
<table class="mt-table" role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="mt-label" style="padding:11px 0;font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:14px;font-weight:400;line-height:140%;color:#637672;text-align:left">Tracking number</td>
<td class="mt-value" align="right" style="padding:11px 0;font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:14px;font-weight:400;line-height:140%;color:#12302a;text-align:right">{{tracking_number}}</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 40px 14px">
<table class="mt-items" role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="mt-rule mt-label" align="left" style="padding:0 0 9px;border-bottom:1px solid #e5e8e8;font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:11.5px;font-weight:600;letter-spacing:1px;text-transform:uppercase;color:#637672;text-align:left">In this shipment</td>
<td class="mt-rule mt-label" align="right" style="padding:0 0 9px;border-bottom:1px solid #e5e8e8;font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:11.5px;font-weight:600;letter-spacing:1px;text-transform:uppercase;color:#637672;text-align:right">Qty</td>
</tr>
{{#each items}}
<tr>
<td class="mt-rule mt-value" align="left" style="padding:12px 0;border-bottom:1px solid #e5e8e8;font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:14px;line-height:140%;color:#12302a;text-align:left">{{description}}</td>
<td class="mt-rule mt-value" align="right" style="padding:12px 0;border-bottom:1px solid #e5e8e8;font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:14px;line-height:140%;color:#12302a;text-align:right">{{quantity}}</td>
</tr>
{{/each}}
</table>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 40px 0px">
<p class="mt-text mt-small" style="margin:0 0 14px;font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:13px;font-weight:400;line-height:165%;letter-spacing:0px;text-decoration:none;color:#637672;text-align:left">Delivery dates are estimates and can change.</p>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:14px 40px 0">
<div class="mt-rule" style="border-top:1px solid #e5e8e8;line-height:0;font-size:0;height:0">&nbsp;</div>
</td>
</tr>
<tr>
<td class="mt-px mt-footer" style="padding:16px 40px 34px;font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:12px;line-height:165%;color:#637672">{{footer_text | You are receiving this email because of your account.}}</td>
</tr>
</table>
</td>
</tr>
</table>
</body>
</html>
Plain text
{{app_name | Your app}}
​
Shipped
Your order is on its way
Hi {{first_name | there}}, order {{order_number}} has shipped.
​
Track package: {{tracking_url}}
​
Carrier: {{carrier}}
​
Estimated delivery: {{estimated_delivery | Soon}}
​
Tracking number: {{tracking_number}}
​
{{#each items}}{{description}} {{quantity}}
{{/each}}
​
Delivery dates are estimates and can change.
​
{{footer_text | You are receiving this email because of your account.}}

More templates

All email templates