Plan: Premium, Enterprise
Platform: All platforms
Applies to: Tracking
Overview
Tracking Clips are compact tracking displays that you embed on a store page or in an email, so shoppers see their shipment status where they already are. L
earn how to set up Tracking Clips using AfterShip. This guide walks you through choosing a clip type, creating a clip, configuring and styling it, and adding it to your store or emails. Once live, shoppers get the same real-time, on-brand updates as your tracking page without navigating away.
Tracking clips on a store page and in an email
Before You Begin
Requirements
Access to edit your site code, to add page clips to your store
Access to edit your email templates in Shopify, Klaviyo, or your email platform, to add email clips
A connected store or the AfterShip Commerce API, to show pre-shipment statuses and tabs for other items in an order
Limitations
Up to 6 tracking clips per organization are supported. Use contact us in the limit notice to request more
Clip names use letters, numbers, spaces, hyphens, and underscores, up to 50 characters
Tabs for other items in an order appear only when the clip opens with an order number, not a tracking number
Step 1: Choose a clip type
Pick the kind of clip based on where it goes. You ca create and style page clips and email clips separately.
Choose a page clip to show tracking status on your storefront.
Choose an email clip to show tracking status inside an email.
Page clip types (Popup, Drawer) and email clip types
Page clips go on your storefront, such as an orders page, an order details page, or anywhere a shopper wants a status without navigating away. Page clips are interactive and open when the shopper clicks a button you add.
Email clips are images that AfterShip renders for each recipient and places in your email content, so shoppers read the update without clicking anything.
Clip | Type | What it shows |
Page clip | Popup | Shipment status in a pop-up window |
| Drawer | Shipment status in a drawer that slides in from the side |
Email clip | Estimated delivery date | The estimated delivery date, with a progress bar and status description |
| Simple progress bar | The status description and a progress bar |
| Locations | Origin and destination, with a status description and progress bar |
| Dates | Ship date, estimated delivery date, status description, and progress bar |
Step 2: Create a tracking clip
Create the clip you chose and give it a name you can find later.
Go to Branded pages > Tracking clips.
Click Create tracking clip, then choose For pages or For emails.
Preview each clip type, then select the one you want.
Enter a clip name you'll recognize later, such as Order details page or Shopify order updates - Locations.
Configure and style the clip in the clip editor (see Step 3 for page clips or Step 5 for email clips).
The Tracking clips list
Note: At the 6-clip limit, choosing a type shows Tracking clip limit reached. Delete or reuse an existing clip, or click contact us in the notice to request more.
Step 3: Configure a page clip
Set what the clip shows and how it looks before you add it to your store.
On the Settings tab, set the clip options.
On the Style tab, set the clip's appearance.
Click Translate content to edit the clip's text in your other languages.
Preview the clip at Desktop and Mobile sizes.
Click Save.
Settings
Option | What it does |
Clip type | Switches the clip between Popup and Drawer |
Tabs for other items in order | Lets shoppers switch between packages inside the clip when an order has several shipments. Enable it on orders and order details pages. Disable it if you only ever ship one package |
Redirect package | Adds a link to the carrier's website so shoppers can request a delivery address change |
Status descriptions | Sets the title and description for each status. Turn each status on or off so the clip only shows the statuses you want |
| Pre-shipment status: requires order data |
| Shipment status: the title and description for each shipment status |
| Error titles and descriptions: shown for expired and non-existent shipments |
Tracking clip settings in clip editor
Style
Option | What it does |
Clip size and shape | Sets the corner radius, padding, width, and height |
Fonts and font size | Sets the text style for the estimated delivery date, title, and body text |
Background, link text, and colors | Sets the clip's background, link text, and colors |
Tracking clip style settings in clip editor
Note: Tabs for other items in order appear only when the clip opens with an order number, not a tracking number. AfterShip also needs your order data from a connected store or the AfterShip Commerce API.
Step 4: Add a page clip to your store
Page clips open from a button on your page, through a small SDK.
Click Add to store on the clip you want, from the Tracking clips list or the clip editor.
Click Copy code. The code has 2 parts: an SDK script tag for the
<head>of your site, and a snippet that opens the clip.Add the SDK script to your site's
<head>.Add a Track button to the page where the clip should open.
Bind the button's click to the clip snippet, passing the shopper's lookup details.
Add to store for a page clip, with the code to copy
SDK script for your site's <head>:
<script src="https://clips.aftership.com/tracking-clips/sdk.js"></script>
Clip snippet, with one of the 4 lookup options:
const clips = new window.AfterShipTrackingClips("YOUR_CLIP_ID");
// Option 1: tracking number
clips.open({ trackingNumber: "YOUR_TRACKING_NUMBER" });
// Option 2: order number + email
clips.open({ orderNumber: "YOUR_ORDER_NUMBER", email: "YOUR_EMAIL" });
// Option 3: order number + phone number
clips.open({ orderNumber: "YOUR_ORDER_NUMBER", phoneNumber: "YOUR_PHONE_NUMBER" });
// Option 4: order number + postal code
clips.open({ orderNumber: "YOUR_ORDER_NUMBER", postalCode: "YOUR_POSTAL_CODE" });Replace the placeholders with your platform's variables for that order.
A tracking clip popup on the order details page
Example: Shopify Hydrogen
Shopify Hydrogen is built on Remix and React. Other stacks, such as Next.js, Vue, or Svelte, need only minor changes.
Add the SDK script tag to
app/root.tsx, inside<head>.Order details page (
app/routes/account.orders.$id.tsx): Add a Track button below View Order Status, and bind itsonClickto the clip snippet.Orders page (
app/routes/account.orders._index.tsx): Add a Track button next to each order's View Order link, and bind it the same way.
<button
style={{ backgroundColor: '#000', color: '#fff', padding: '12px 20px', borderRadius: '8px', cursor: 'pointer' }}
onClick={() => {
const clips = new window.AfterShipTrackingClips("YOUR_CLIP_ID");
clips.open({ orderNumber: order.number, email: order.email });
}}
>
Track
</button>
Step 5: Configure an email clip
Set what the email clip shows and how it looks before you add it to your emails.
On the Settings tab, set the clip options.
On the Style tab, set the clip's appearance.
Click Save.
Settings
Option | What it does |
EDD (estimated delivery date) | Shows the estimated delivery date, and the delivered date once the shipment arrives. Set it to Enabled |
Progress bar | Sets how the clip draws the shipment journey |
| Dates: from date to date |
| Locations: from origin to destination |
| Line: a simple overall progress line |
Status descriptions | Uses the same Pre-shipment status, Shipment status, and Error titles and descriptions options as page clips
|
Email clip settings in clip editor
Style
Option | What it does |
Clip size and color | Sets the clip's size and color |
Font, font size, text color, and alignment | Sets the text style for the estimated delivery date, progress bar, dates, or locations |
Email clip style settings in clip editor
Step 6: Add an email clip to your emails
An email clip is an image whose URL carries the clip ID and the shipment to show. Your email platform fills in the tracking number with its own merge tag, so each recipient sees their own shipment.
Click Add to email on the clip you want, from the Tracking clips list or the clip editor.
Click Copy code from the popup.
Replace
YOUR_TRACKING_NUMBERwith your email platform's tracking-number merge tag.Paste the code into your email template and preview it.
Send yourself a test email against a real order before you send to a list.
The copied code looks like this:
<img src="https://clips.aftership.com/api/tracking-clips/email?clip_id=YOUR_CLIP_ID&tracking_number=YOUR_TRACKING_NUMBER" alt="AfterShip Tracking Clips" width="100%" />
Warning: A wrong merge tag shows nothing, or an error, for every recipient. Test against a real order before you send to a list.
Shopify customer notifications
In your Shopify admin, go to Settings > Notifications > Customer notifications.
Open Shipping confirmation, Shipping update, Out for delivery, or Delivered, then click Edit code.
Use
{{ fulfillment.tracking_numbers.first }}as the tracking number.
a. In Shipping confirmation, Shipping update, and Delivered, place the clip above the View your order button.
b. In Out for delivery, place the clip above the Track my shipment button.
Preview, send a test email, and save.
<td class="actions__cell">
<img src="https://clips.aftership.com/api/tracking-clips/email?clip_id=YOUR_CLIP_ID&tracking_number={{ fulfillment.tracking_numbers.first }}" alt="AfterShip Tracking Clips" width="100%"/>
<table class="button main-action-cell">
<tr>
<td class="button__cell"><a href="{{ order_status_url }}" class="button__text">View your order</a></td>
</tr>
</table>
</td>
Add the clip to a Shopify notification template
Klaviyo
In Klaviyo, go to Flows and open the email editor for the flow.
Drag an HTML block into the email.
Replace the block's content with the clip code, using
{{ event.AllShipmentsInThisOrder.0.TrackingNumber|default:'' }}as the tracking number.Preview and test the flow, then save.
<img src="https://clips.aftership.com/api/tracking-clips/email?clip_id=YOUR_CLIP_ID&tracking_number={{ event.AllShipmentsInThisOrder.0.TrackingNumber|default:'' }}" alt="AfterShip Tracking Clips" width="100%">Note: If the flow's event source isn't AfterShip, the property name differs. Find the tracking number in your event's property list.
Klaviyo HTML block with the clip code
To stop showing a clip, remove the clip code from your store page or email template.
What Your Shoppers Will Experience
After completing these steps:
Shoppers click Track on your store page and see their shipment status in a popup or drawer
Shoppers with multi-shipment orders switch between packages using tabs inside the page clip
Shoppers see their shipment status as an image in your emails, without clicking anything
You see how many of your 6 clips you've used in the Tracking clips list
Troubleshooting
Problem | Cause | Solution |
The email clip shows nothing or an error | The tracking-number merge tag is wrong | Replace |
The Klaviyo email clip is blank | The flow's event source isn't AfterShip, so the property name differs | Find the tracking number in your event's property list and use that property |
Package tabs don't appear in the page clip | The clip opens with a tracking number, or AfterShip has no order data | Enable Tabs for other items in order, open the clip with an order number, and connect your store or the AfterShip Commerce API |
The pre-shipment status doesn't show | AfterShip has no order data | Connect your store or use the AfterShip Commerce API |
I can't create a new clip | Your organization reached the 6-clip limit | Delete or reuse an existing clip, or click contact us in the limit notice |
FAQs
1. How many tracking clips can I create?
You can create up to 6 tracking clips per organization. To request more, click contact us in the Tracking clip limit reached notice.
2. Can I rename, duplicate, or delete a tracking clip?
Yes. You can rename, duplicate, and delete clips from the Tracking clips list.
3. Can I translate the text in a tracking clip?
Yes. In the page clip editor, click Translate content to edit the clip's text in your other languages.
4. Can I add page clips to a store that doesn't use Shopify Hydrogen?
Yes. The Shopify Hydrogen steps are an example. Other stacks, such as Next.js, Vue, or Svelte, need only minor changes.
5. Where should I add tracking clips?
Add clips where shoppers already look for status. On the order confirmation page, the status appears as soon as there is one, without a second visit. On account and order history pages, the status shows next to each order. In shipping notification emails and marketing emails to recent buyers, the update sits in the message, which makes the email more likely to be opened.
6. Should I use tracking clips or a tracking page?
Use both. A clip tells shoppers where their package is. A tracking page answers that too, and gives you room for branding, recommendations, returns entry points, and support. Use clips as the quick answer in context, and keep the tracking page as the destination when shoppers want more.
Key Takeaways
Tracking Clips show shipment status on your store pages or in emails, without opening your tracking page
Choose page clips for your storefront and email clips for emails; you create and style each separately
Tracking Clips are available on the Premium and Enterprise plans, on all platforms
Shoppers open page clips from a Track button and see email clips as an image in the message
A wrong tracking-number merge tag shows nothing, or an error, to every email recipient











