Platforms: All platforms
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
Plans: All plans
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:
Navigate to URLs and domains in your AfterShip Tracking Admin.
Choose either the Universal URL or Page URL.
Click Copy URL.
2. Merchants-hosted URL with custom domain
Plans: Premium, Enterprise
For businesses on the AfterShip Premium and above plans, 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}/
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
Plans: Non-API Enterprise Platforms: Shopify
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
Key | Required | Example | Remarks |
| Yes |
| Required to track a specific shipment. |
| Yes |
| Required for features like tracking items and shipments that are split. |
| No |
| Allows you to specify the language for the tracking page. If omitted, the page will auto-switch to match the user’s browser language. |
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
Please avoid inserting curly brackets before and after the parameters or spaces between parameters or paths in the URL. Spaces and curly brackets have been added in the example URLs below solely for clarity and to highlight the parameters.
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:
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:
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.
For example:
Language parameters format
Language code | Language |
ar | Arabic |
bg | Bulgarian |
cs | Czech |
da | Danish |
de | German |
el | Greek |
en | English |
es | Spanish |
fi | Finnish |
fr | French |
fr-CA | French (Canada) |
he | Hebrew |
hr | Croatian |
hu | Hungarian |
id | Indonesian |
it | Italian |
ja | Japanese |
km | Khmer |
ko | Korean |
nb | Norwegian Bokmål |
nl | Dutch |
pl | Polish |
pt | Portuguese |
ro | Romanian |
ru | Russian |
sk | Slovakian |
sl | Slovenian |
sv | Swedish |
th | Thai |
tl | Tagalog |
tr | Turkish |
vi | Vietnamese |
zh-Hans | Chinese (Simplified) |
zh-Hant | Chinese (Traditional) |