Once you've integrated your tracking page, you can customize some settings to decide what to display to your customers. For instance, if you have a website in French and one in English, you can enable both languages for your tracking page and then manually force French on your French website and English on the other one.
We offer two ways to pass arguments to your tracking page. Through the ShipupJS argument object or URL parameters.
ShipupJS argument object
If you've integrated your tracking page through ShipupJS, you can pass an object (keys: shipup allowed arguments, values: their values) as the second argument to the render method of your ShipupJS object:
On our Shopify or self-hosted integration, since you're not accessing Shipup's code directly, the previous option is not available. In that case, you can pass your arguments through URL parameters. If your page is hosted at, e.g. https://www.my-shop.com/tracking, then you can add a query parameter to the URL like so
Please note that this parameter must start with a
? symbol and each new parameter must be separated by a
The resulting URL is: https://www.my-shop.com/tracking?language=fr&searchEnabled=false
You can use both the argument object and the URL parameters at the same time, but be aware that the argument object will always have precedence over the URL parameters.
If you wish to check how the tracking page will render on your website, you can use the
testScenario argument. Setting its value to
two_trackers, for instance, will simulate the tracking of an order containing two packages. See the "Passing arguments to your tracking page" section above for a recap of how to pass arguments and available values for
You can force the tracking page to display a specific package:
- Using the
trackerUuidvariable. You will generally not have access to this information but all links to the tracking page coming from Shipup shipment notifications will use this information to identify the package.
- Using the
You can also force the tracking page to display a specific order:
- Using the
For instance, for an order with order number 12345 and its tracker with tracking number ABCDE, if we use the same example tracking page as in the section above, a customer could access their order tracking on the URL:
and their shipment tracking on the URL:
Here's the list of arguments you can pass to your tracking page :
If set, the tracking page will display sample orders. Used for testing different configurations of your tracking page.
Used to force a language. If not provided, the customer's browser preferences will be checked to select the best language
Used to force the display type. If not provided, will switch automatically from desktop to mobile if the viewport is below 500 pixels
ID identifying the package tracked on this page
Used by Shipup, you won't have access to this ID
Package tracking number.
Used to identify a package
Used to identify an order
Defaults to true. Enable/disable the option for customers to search for orders by email/tracking number
Updated about 1 year ago