Skip to main content

Set up Tracking Clips

Written by Harneet Kaur

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.

  1. Choose a page clip to show tracking status on your storefront.

  2. 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.

  1. Go to Branded pages > Tracking clips.

  2. Click Create tracking clip, then choose For pages or For emails.

  3. Preview each clip type, then select the one you want.

  4. Enter a clip name you'll recognize later, such as Order details page or Shopify order updates - Locations.

  5. 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.

  1. On the Settings tab, set the clip options.

  2. On the Style tab, set the clip's appearance.

  3. Click Translate content to edit the clip's text in your other languages.

  4. Preview the clip at Desktop and Mobile sizes.

  5. 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.

  1. Click Add to store on the clip you want, from the Tracking clips list or the clip editor.

  2. 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.

  3. Add the SDK script to your site's <head>.

  4. Add a Track button to the page where the clip should open.

  5. 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 its onClick to 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.

  1. On the Settings tab, set the clip options.

  2. On the Style tab, set the clip's appearance.

  3. 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

  • To show pre-shipment statuses, you must connect your store or use the AfterShip Commerce API to provide AfterShip with the order resources.

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.

  1. Click Add to email on the clip you want, from the Tracking clips list or the clip editor.

  2. Click Copy code from the popup.

  3. Replace YOUR_TRACKING_NUMBER with your email platform's tracking-number merge tag.

  4. Paste the code into your email template and preview it.

  5. 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

  1. In your Shopify admin, go to Settings > Notifications > Customer notifications.

  2. Open Shipping confirmation, Shipping update, Out for delivery, or Delivered, then click Edit code.

  3. 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.
    ​

  4. 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

  1. In Klaviyo, go to Flows and open the email editor for the flow.

  2. Drag an HTML block into the email.

  3. Replace the block's content with the clip code, using {{ event.AllShipmentsInThisOrder.0.TrackingNumber|default:'' }} as the tracking number.

  4. 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 YOUR_TRACKING_NUMBER with your platform's merge tag, then test against a real order

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

Did this answer your question?