Complete Guide to AfterShip Tracking Page URL Types & Configuration

Overview

The guide outlines the different types of URLs available for embedding AfterShip’s tracking page into your website, as well as how to configure each type based on your hosting setup.

1. AfterShip-hosted default URL

When you use AfterShip’s standard service, it automatically creates a free tracking URL for you. This URL is used for both universal (default and segmentation-based) and page-specific tracking pages.

URL Types

A. Universal URL: This URL directs customers to your default tracking page, which may include different variations of your default page based on segmentation rules.

• The default page is used when customers don't meet any segmentation rules, and also for your order lookup page before customers enter their order or tracking number.
• When you use segmentation, it will show your customers a variation based on the pre-defined segmentation rules.

Learn more about the ** role of Universal URL in creating segmentation rules **.

**Example: **

https://{org_short_name}.aftership.com/

B. Page URL: This URL leads to a specific tracking page you have created.

• You can create and design different tracking pages to offer customize tracking experience for your customers.
• Each tracking page variation you create will have a unique tracking page URL.

**Example: **

https://{org_short_name}.aftership.com/?page-name={page_name}

How to find your default AfterShip tracking page URL:

1. Log in to AfterShip Tracking Admin.
2. Navigate to URLs and domains.
3. Choose either the Universal URL or Page URL.
4. Click Copy URL.

2. Merchants-hosted URL with custom domain

For businesses on AfterShip Premium and above plan, you can use your own custom domain. AfterShip will apply this domain to both your universal URL and any page-specific URLs.

URL Types:

A. Universal URL: This URL directs customers to your default tracking page with your own custom domain, which may include variations based on segmentation rules.

**Example: ** https://{custom_domain}/

https://track.happytrading.com/

B. Page URL: This URL leads to a specific tracking page (variation) you have created with your own custom domain.

**Example: **

https://{custom_domain}/?page-name={page_name}

How to set up a custom domain

To set up a custom domain, follow the instructions provided here.

3. Shopify-hosted proxy URL

For Shopify store owners, you can embed the AfterShip branded tracking page into your Shopify store using a proxy URL. This allows your customers to access tracking information while keeping the same look and feel as your store, ensuring a consistent user experience.

Example URLs:

• https://{Shopify_store_key}.myshopify.com/apps/{custom_suffix}
• https://{Shopify_store_key}.myshopify.com/a/{custom_suffix}
• https://{Shopify_store_key}.myshopify.com/community/{custom_suffix}
• https://{Shopify_store_key}.myshopify.com/tools/{custom_suffix}

How to embed tracking page using the Shopify Proxy URL

To learn more about setting up the Shopify proxy URL, follow the instructions here.

Tracking URL Parameters

When you provide customers with a link to track their orders, the URL can be customized with parameters to display specific information. Common parameters include tracking_number, order_number, and email or phone_number for more granular tracking.

Common Parameters:

1. Order Number + Email/Phone Number

You can bypass the Order Lookup page by pre-setting AfterShip’s order number parameters in the URL, allowing consumers to directly view the tracking results page. Pre-set the order number along with email or phone number to display tracking updates, item details, and other shipment information.

💡 AfterShip requires either an email or phone number as parameters when looking up an order by order number.

How to pre-set the order number + email/phone number parameters for different URL types

A. AfterShip-hosted default URL

• Universal URL: https://{org short name}.aftership.com/order-status?order-number={order number}&email={email}
• Page URL: https://{org short name}.aftership.com/order-status?order-number={order number}&phone-number={phone number}&page-name={page name}

B. Merchant’s custom domain URL:

• Universal URL: https://{custom domain}/order-status?order-number={order number}&email={email}
• Page URL: https://{custom domain}/order-status?order-number={order number}&email={email}&page-name={page name}

C. ** **Shopify-hosted proxy URL

• {Shopify store key}.myshopify.com/apps/{custom suffix}/order-status?order-number={order number}&email={email}
• {Shopify store key}.myshopify.com/a/{custom suffix}order-status?order-number={order number}&email={email}

**For example: **

https://track.happytrading.com/order-status?order-number=1038&email=alex@happytrading.com

https://happytrading.com/apps/aftership/order-status?order-number=1038&email=alex@happytrading.com

2. Tracking Number

To bypass the Order Lookup page, you can pre-set AfterShip’s tracking number parameters in the URL to show the tracking results page directly to consumers.

💡 Using the tracking number as the pre-set parameter means shoppers won't have access to order-level information like items, other shipments, etc.

How to pre-set the tracking number parameter to display tracking updates for different URL types

A. ** **AfterShip-hosted default URL

• Universal URL: https://{org short name}.aftership.com/{tracking_number}
• Page URL: https://{org short name}.aftership.com/{tracking_number}?page-name={page name}

B. Merchant’s custom domain URL:

• Universal URL: https://{custom domain}/{tracking_number}
• Page URL: https://{custom domain}/{tracking_number}?page-name={page name}

C. Shopify-hosted proxy URL

• {Shopify store key}.myshopify.com/apps/{custom suffix}/{tracking_number}
• {Shopify store key}.myshopify.com/a/{custom suffix}/{tracking_number}

**For example: **

• https://track.happytrading.com/1ZC1F976YW83782196
• https://shop.swan-brand.co.uk/apps/aftership/1ZC1F976YW83782196
• https://track.happytrading.com/1ZC1F976YW83782196

3. Language

You can add a language parameter to the URL to display the tracking page in different languages. Simply append a language code to the URL.

How to pre-set the language parameter to display the tracking page in a specific language.

https://{domain}/{tracking_number}? lang=da

https://{domain}/order-status? order-number={order number} & email={email} & lang=da

For example:

• https://track.happytrading.com/TEST105301E000?lang=da
• https://track.happytrading.com/order-status?order-number=1038&email=alex@happytrading.com&lang=da

Language parameters format

**

Updated on: 07/01/2025