Plans: All plans
Platforms: Shopify
Applies to: Tracking pages, Returns pages
Overview
A Shopify app proxy serves your AfterShip pages from a path on your own store domain, such as yourstore.com/apps/aftership/tracking, instead of an AfterShip URL, with no DNS changes. Learn how to add your Tracking and Returns pages to your Shopify store using the proxy URL in AfterShip. This guide walks you through setting up the proxy URL, redirecting existing tracking links, adding the URL to your store and notifications, and editing the URL later. Once live, shoppers open your pages between your store's header and footer, matching your theme, which makes the proxy the fastest route to a branded URL on Shopify.
Before You Begin
Requirements
A Shopify store connected to AfterShip Platform
Access to your Shopify admin
Limitations
Shopify controls the header and footer around your page
You configure everything inside the page (order lookup widget, reviews, styling, chat widget) in the page editor as usual
The proxy URL covers Tracking and Returns pages only. For Warranty pages, use the page URL or a custom domain
AfterShip and Shopify don't sync the app handle, so any change needs updating in both places
Step 1: Set Up the Proxy URL
Choose where your proxy URLs point, then copy the URL you need.
Go to Branded pages > URLs and embedding and open Embed using Shopify proxy URL.
Under Your proxy URLs, find the Shopify store you want to set up. If your organization has several stores, each store has its own proxy URLs.
Under Blank path, choose whether
yourstore.com/apps/aftershipopens the tracking experience or the Returns page.Under Tracking URL destination, choose what the tracking proxy URL points to:
Default page or follow segmentation rules: If you haven't set up segmentation, shoppers see your default Tracking page. If you have, AfterShip routes each shopper to the page whose rules they match. Choose this option unless you have a reason not to, because you can change routing later without changing the link.
Specific page: Every shopper sees the one Tracking page you pick, regardless of rules.
Click Copy proxy URL next to the URL you need.
The Embed using Shopify proxy URL settings in URLs and embedding
How your proxy URL is built
Two values define the proxy URL path:
Proxy URL prefix: The first segment, one of
apps,a,community, ortoolsApp handle: The segment after the prefix, which you choose
Together they produce yourstore.com/{prefix}/{handle}. One proxy path serves both your tracking and returns pages:
Path | What it opens |
| The blank path: Tracking or Returns, whichever you choose under Blank path |
| Your tracking experience |
| Your Returns page |
The app handle in AfterShip and the App proxy value in Shopify
Warning: AfterShip and Shopify don't sync the app handle, so changing it on one side doesn't update the other. If you change the handle, update it in both places or the proxy URL stops working (see Step 8).
Step 2: Redirect Existing Tracking Links to the Proxy URL
Catch tracking links that already exist, so shoppers who click a tracking number in Shopify or in an email land on your branded page instead of the carrier's site.
In Embed using Shopify proxy URL, go to Redirecting Tracking links to your proxy URL.
Turn on From Shopify links. Tracking links that Shopify shows in your store and emails redirect to your proxy URL tracking page instead of the carrier's website. This covers the order status page, the customer account order history, and the order details page in your Shopify admin.
Turn on From notifications. Tracking links that AfterShip provides for use in notifications, APIs, webhooks, and third-party integrations redirect to your proxy URL tracking page.
A tracking link on the Shopify order status page opening the Tracking page
Step 3: Add the Proxy URL to Your Store Navigation
Once the proxy is live, use the URL everywhere shoppers meet a tracking or returns link, starting with your store menu.
In your Shopify admin, go to Content > Menus.
Open the Main menu or Footer menu.
Click Add menu item, enter a name such as Track your order or Returns, paste the proxy URL in the link field, and click Add.
Drag the item into position and click Save menu.
Open your store and click the new item to confirm it opens the right page.
Adding a menu item in Content > Menus
Tip: Add the tracking link to your main menu. It's the easiest place for shoppers to find it.
Step 4: Link the Proxy URL From Your Return Policy and FAQ Pages
Point shoppers to your pages from the content they already read.
In your Shopify admin, go to Online store > Pages.
Open your return policy page, select the text you want to link, and link it to the returns proxy URL.
Create an FAQ article such as "Where is my order?" and paste the tracking proxy URL into it.
Step 5: Add the Proxy URL to Shopify Notification Emails
Replace the default order status link in Shopify's customer notifications, so the View your order button opens your Tracking page. We recommend doing this for Order confirmation, Shipping confirmation, Shipping update, Out for delivery, and Delivered.
In your Shopify admin, go to Settings > Notifications > Customer notifications.
Open Order confirmation (under Order processing) and click Edit code.
In the email body (HTML), find this line:
<a href="{{ order_status_url }}" class="button__text">View your order</a>Replace it with the following line, using your own tracking proxy URL in place of
https://yourstore.myshopify.com/apps/aftership/tracking:
<a href="https://yourstore.myshopify.com/apps/aftership/tracking/order-status?order-number={{ order_number }}&email={{ email }}" class="button__text">View your order</a>Click Preview, send a test email, and click View your order in the test to confirm it opens the Tracking page.
Save, then repeat these steps for the other notifications. In Out for delivery, the button is Track my shipments.
Editing the Order confirmation template in Shopify
Step 6: Add the Proxy URL to Klaviyo Notifications
Send shoppers from Klaviyo emails and SMS to your Tracking page.
Turn on From notifications under Redirecting Tracking links to your proxy URL (Step 2).
In Klaviyo, open the flow and add a Track order status button to the email or SMS.
Paste
{{ event.OrderTrackingURL|default:'' }}to open the order with all its shipments, or{{ event.ShipmentTrackingURL|default:'' }}to open a single shipment.Preview and test before saving.
Adding a Track order status button in a Klaviyo flow
Step 7: Add the Proxy URL to AfterShip Notifications
Send shoppers from AfterShip notifications to your Tracking page.
Turn on From notifications under Redirecting Tracking links to your proxy URL (Step 2).
In AfterShip, go to Notifications > Flows and edit the flow.
Click Edit email content under the Preview section of the sidebar. The sidebar to edit email will automatically open once you hover over the email card on the Preview screen.
On the email editor, add a Track order status button, or edit the default track button, and use Insert merge tag to pick Tracking URL (single shipment) or Order URL (the whole order).
Preview and test before saving.
Step 8: Edit the Proxy URL
Change the prefix or the handle after setup, and keep AfterShip and Shopify in sync.
In Embed using Shopify proxy URL, open the … menu next to your proxy URL and click Edit proxy URL.
Pick the new prefix from the dropdown or change the handle. AfterShip previews the new URL below the fields.
Click Edit proxy URL in Shopify and make the same change there. To do this manually:
In your Shopify admin, go to Settings > Apps and sales channels, select the AfterShip app, scroll to App proxy, click Customize URL, make the same change, and save.
Update any menu items, templates, or integrations that used the old URL.
The Update proxy URL dialog
Important: The proxy URL in AfterShip must match the App proxy URL in Shopify. AfterShip and Shopify don't sync automatically, so changing one side does nothing to the other.
What You and Your Shoppers Will Experience
After completing these steps:
Shoppers open your Tracking and Returns pages on your own store domain, between your store's header and footer
Shoppers who click a tracking link on the order status page or in their customer account order history land on your Tracking page instead of the carrier's website
Shoppers who click View your order in Shopify emails, or the track button in Klaviyo and AfterShip notifications, open your Tracking page
Shoppers find Track your order and Returns in your store menu
You open your Tracking page from the order details page in your Shopify admin
Troubleshooting
Problem | Cause | Solution |
The proxy URL stopped working after I changed the handle | AfterShip and Shopify don't sync the app handle | Make the same change in Shopify's App proxy setting (Step 8) |
Tracking links in Shopify still open the carrier's website | From Shopify links is off | Turn on From Shopify links (Step 2) |
Tracking links in Klaviyo or AfterShip notifications don't open my Tracking page | From notifications is off | Turn on From notifications (Step 2) |
My menu or email button opens the old URL after I edited the proxy URL | The link still uses the old proxy URL | Update menu items, templates, and integrations with the new URL |
Every shopper sees the same Tracking page despite my segmentation rules | Tracking URL destination is set to Specific page | Switch to Default page or follow segmentation rules (Step 1) |
FAQs
1. Do I need DNS access to use the proxy URL?
No. The proxy needs no DNS access and works immediately.
2. Should I use the proxy URL or a custom domain?
Start with the proxy URL, because it needs no DNS access and works immediately. A custom domain gives a cleaner address and works for non-Shopify stores. Many merchants start with the proxy and move to a custom domain later. See Set up a custom domain for your pages.
3. Does my proxy URL change if I used AfterShip Classic?
Yes. If you used Branded Tracking Page or Branded Returns Page on AfterShip Classic, your proxy URL changes, because tracking and returns now share one prefix. Update your Shopify notification templates, store navigation, hard-coded links, and any integrations or support macros that embed the old URL. Turn on the switches under Redirecting Tracking links to your proxy URL so old tracking links still redirect to your branded page.
4. Do I need separate proxy URLs for tracking and returns?
No. One proxy prefix serves both: /apps/aftership/tracking for tracking and /apps/aftership/returns for returns.
5. Can I use the proxy URL for my Warranty page?
No. Warranty pages don't have a proxy URL. Use the page URL or a custom domain instead.
6. I have several Shopify stores. Do they share one proxy URL?
No. Each connected Shopify store has its own proxy URLs under Your proxy URLs.
Key Takeaways
The proxy URL serves your Tracking and Returns pages from a path on your Shopify store domain
Default page or follow segmentation rules lets you change routing later without changing the link
The proxy URL works for Tracking and Returns pages on Shopify, not Warranty pages
Shoppers see your pages between your store's header and footer, matching your theme
AfterShip and Shopify don't sync the app handle, so update both when you change it






