Skip to main content

Add Pages to Your Shopify Store Using the Proxy URL

Written by Harneet Kaur

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.

  1. Go to Branded pages > URLs and embedding and open Embed using Shopify proxy URL.

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

  3. Under Blank path, choose whether yourstore.com/apps/aftership opens the tracking experience or the Returns page.

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

  5. 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, or tools

  • App 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

yourstore.com/apps/aftership

The blank path: Tracking or Returns, whichever you choose under Blank path

yourstore.com/apps/aftership/tracking

Your tracking experience

yourstore.com/apps/aftership/returns

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.

  1. In Embed using Shopify proxy URL, go to Redirecting Tracking links to your proxy URL.

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

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

  1. In your Shopify admin, go to Content > Menus.

  2. Open the Main menu or Footer menu.

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

  4. Drag the item into position and click Save menu.

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

  1. In your Shopify admin, go to Online store > Pages.

  2. Open your return policy page, select the text you want to link, and link it to the returns proxy URL.

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

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

  2. Open Order confirmation (under Order processing) and click Edit code.

  3. In the email body (HTML), find this line:
    ​

    <a href="{{ order_status_url }}" class="button__text">View your order</a>

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

  5. Click Preview, send a test email, and click View your order in the test to confirm it opens the Tracking page.

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

  1. Turn on From notifications under Redirecting Tracking links to your proxy URL (Step 2).

  2. In Klaviyo, open the flow and add a Track order status button to the email or SMS.

  3. Paste {{ event.OrderTrackingURL|default:'' }} to open the order with all its shipments, or {{ event.ShipmentTrackingURL|default:'' }} to open a single shipment.

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

  1. Turn on From notifications under Redirecting Tracking links to your proxy URL (Step 2).

  2. In AfterShip, go to Notifications > Flows and edit the flow.

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

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

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

  1. In Embed using Shopify proxy URL, open the … menu next to your proxy URL and click Edit proxy URL.

  2. Pick the new prefix from the dropdown or change the handle. AfterShip previews the new URL below the fields.

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

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

Did this answer your question?