Skip to main content

Learn about page URLs and domains

Written by Harneet Kaur

Plan: All plans (custom domains: Premium, Enterprise)
​Platform: All platforms (Shopify proxy URL: Shopify only)
​Applies to: Tracking, Returns, and Warranty pages

Overview

URLs and domains is where you connect a page you've built to your storefront, because building a page doesn't put it in front of shoppers. It covers four things: domains and page URLs, the Shopify proxy URL, iframe embedding, and the order lookup widget. This article explains how domains, page URLs, and URL parameters work, and compares the four insertion methods so you can choose one. Start here, then read the article for the method you're using.

Manage all your domains in one place

The URLs and embedding > Domains and page URLs tab

You manage domains for Tracking, Returns, Warranty, and Protection pages in one place: Branded pages > URLs and embedding > Domains and page URLs. One domain can serve all your pages, with each product on its own path.

Merchants on the Premium plan of any product can add 1 custom domain, and those on Enterprise can add up to 5.

When you create your organization, AfterShip sets up a default domain automatically. The format is {short_name}.aftership.com, where {short_name} is your organization's short name. For example, with luxe.aftership.com:

Path

Opens

luxe.aftership.com/tracking

Tracking page

luxe.aftership.com/returns

Returns page

luxe.aftership.com/warranty/{page_name}

Warranty page

luxe.aftership.com/protection

Protection page

The blank path (luxe.aftership.com/) redirects to the page you choose: Tracking or Returns. To set it, click the … (more actions) menu on the domain row, then select Redirect destination.

The more actions menu on a domain row, with Redirect destination

A custom domain such as shopper.luxe.com works the same way, with the same paths. You can also give products separate domains, for example returns.luxe.com for returns and track.luxe.com for tracking. See Set up a custom domain for your pages.

Note: If you're an existing merchant, this is the biggest practical change. You previously configured domains separately in each product; you now manage them all in one place.

Page URLs

The universal URL and per-page URLs in Domains and page URLs

Domains and page URLs lists every URL under your domain, each with a Copy URL button. The list includes:

  • A universal tracking URL

  • One ?page-name= URL per Tracking page

  • The Returns page URL

  • One URL per Warranty page under /warranty/

  • A Protection URL, if you use AfterShip Protection

Universal URL and page URL (Tracking)

A universal URL doesn't point to a specific Tracking page. It follows your segmentation rules and sends each shopper to the page that matches them. If you haven't set up segmentation, it opens your default page. Shoppers also see the default page on the order lookup step, before they enter an order or tracking number.

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

A page URL always opens one specific Tracking page, regardless of rules.

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

Use the universal URL in notification emails and storefront links. You can then change which shoppers see which page by editing segmentation rules, without republishing every link. Use a page URL when you want every shopper on the same page.

Both URL types work the same way on a custom domain and on a Shopify proxy URL:

URL type

Universal URL

Page URL

Custom domain

https://{custom_domain}/

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

Shopify proxy URL

https://{store}.myshopify.com/apps/{handle}/…

Tip: Keep paths short and predictable, such as /track and /returns. Shoppers type these, read them out over the phone, and see them in your notification emails.

URL parameters

Add parameters to any tracking URL so the shopper skips the lookup form and lands on their result.

Parameter

Required

Example

Notes

tracking_number

Either this or order number with email or phone

1ZC1F976YW83782196

Opens a single shipment. The shopper doesn't see order-level information, such as items or other shipments.

order-number with email or phone-number

Either this or tracking number

Opens the order with all its shipments and items. Always include an email or phone number with the order number.

lang

No

da

Sets the page language. Without it, the page follows the shopper's browser language.

Order number with email or phone (deep link)

  • Universal URL: https://{domain}/order-status?order-number={order_number}&email={email}

  • Page URL: https://{domain}/order-status?order-number={order_number}&phone-number={phone_number}&page-name={page_name}

  • Shopify proxy URL: https://{store}.myshopify.com/apps/{handle}/order-status?order-number={order_number}&email={email}

Example: https://track.happytrading.com/order-status?order-number=1038&[email protected]

Tracking number

  • Universal URL: https://{domain}/{tracking_number}

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

  • Shopify proxy URL: https://{store}.myshopify.com/apps/{handle}/{tracking_number}

Example: https://track.happytrading.com/1ZC1F976YW83782196

Language

Add lang={code} to any of the URLs above, for example https://track.happytrading.com/1ZC1F976YW83782196?lang=da. Use the language code of a language you've added to the page, such as da, de, fr-CA, or zh-Hans. The lang parameter also works on the Returns page URL. Warranty pages don't support language parameters in URLs See Enable and customize page content in multiple languages.

Note: Don't include curly brackets or spaces in a real URL. The examples use them only to mark placeholders.

The four ways to get a page in front of shoppers

  1. Custom domain: AfterShip serves your pages from your own domain, such as track.yourbrand.com. This is the strongest option for brand continuity, and the one to choose if you can change DNS (Domain Name System) settings. See Set up a custom domain for your pages.

  2. Shopify proxy URL: AfterShip serves your pages from a path on your Shopify store domain, between your store's header and footer. You don't need to change DNS. See Add pages to your Shopify store using the proxy URL.

  3. iframe: You embed your pages inside an existing page on your site, so your own header, footer, and navigation stay around them. See Embed pages into your store using an iframe.

  4. Order lookup widget: You place a lookup form on your storefront that sends shoppers to the page. Merchants usually combine it with one of the other methods rather than using it alone. See Set up the order lookup widget (Track button).

Available methods of embedding differ by page type. See each method's article for details.

Choose the embedding method

  • On Shopify and want it working today: Use the proxy URL.

  • Want the strongest branding and can change DNS: Use a custom domain.

  • Need your own site navigation around the page: Use an iframe.

  • Not on Shopify: Use a custom domain or an iframe.

These methods aren't exclusive. A common combination is a custom domain for the main URL plus an order lookup widget on the storefront.

Keep your links consistent

Whichever method you choose, use the same URL everywhere: notification emails, SMS, storefront links, and support macros. Shoppers who reach the same page from two different addresses report it as a bug. Two addresses also make your traffic data harder to read.

FAQ

1. Where do I find my page URLs?

Go to Branded pages > Page insertion > Domains and page URLs. Every URL under your domain appears there with a Copy URL button.

2. What's the difference between a universal URL and a page URL?

A universal URL follows your segmentation rules and opens the matching Tracking page for each shopper. A page URL always opens one specific Tracking page.

3. Can I use a different domain for each product?

Yes. Add several custom domains and assign each product its own, for example returns.luxe.com and track.luxe.com.

4. Can I link shoppers straight to their order?

Yes. Add the order number with an email or phone number, or a tracking number, to the URL. The shopper skips the lookup form and lands on their result.


5. Do Warranty pages support the lang parameter?

No. The lang parameter works on Tracking and Returns page URLs only.

Key takeaways

  • Page insertion connects your pages to your storefront through a domain, proxy URL, iframe, or lookup widget

  • Use the universal URL in emails and links so segmentation rules decide which Tracking page opens

  • The Shopify proxy URL works on Shopify only; other stores use a custom domain or an iframe

  • Shoppers who open a URL with order or tracking parameters skip the lookup form

  • Use one URL everywhere, since two addresses for one page confuse shoppers and split traffic data

Did this answer your question?