---
updatedAt: 2025-11-11T23:05:28.000Z
agentTools:
  projectIndex: https://developers.shipup.co/llms.txt
---

# Configuring your tracking page

## Overview

Once you've [integrated your tracking page](https://developers.shipup.co/docs/installing-shipupjs), 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.

## Passing arguments to your tracking page

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:

```html
<script type="text/javascript">
  var shipup = new ShipupJS.default('myPublicApiKey');
  var element = document.getElementById('shipup-container');
  var arguments = {
    language: 'fr',
    searchEnabled: false
  };
  shipup.render(element, arguments);
</script>
```

**URL parameters**

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 <code>?language=fr\&searchEnabled=false</code>.

Please note that this parameter must start with a <code>?</code> symbol and each new parameter must be separated by a <code>&</code> symbol.

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.

## Testing data

If you wish to check how the tracking page will render on your website, you can use the <code>testScenario</code> argument. Setting its value to <code>two\_trackers</code>, 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](https://developers.shipup.co/docs/test-scenarios) for <code>testScenario</code>.

## Display a specific order or package on the tracking page

You can force the tracking page to display a specific package:

* Using the <code>trackerUuid</code> variable. 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 <code>trackingNumber</code> parameter.

You can also force the tracking page to display a specific order:

* Using the <code>orderNumber</code> parameter.

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:

<https://www.my-shop.com/tracking?orderNumber=12345>

and their shipment tracking on the URL:

<https://www.my-shop.com/tracking?trackingNumber=ABCDE>

## Available arguments

Here's the list of arguments you can pass to your tracking page :

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        ARGUMENT
      </th>

      <th>
        DESCRIPTION
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **testScenario**
        string, see available values [here](https://developers.shipup.co/docs/test-scenarios)
      </td>

      <td>
        If set, the tracking page will display sample orders. Used for testing different configurations of your tracking page.
      </td>
    </tr>

    <tr>
      <td>
        **language**\
        string, one of <code>fr</code>, <code>en</code>, <code>de</code>, <code>es</code>, <code>it</code>, <code>nl</code>, <code>pl</code>, <code>da</code>
      </td>

      <td>
        Used to force a language. If not provided, the customer's browser preferences will be checked  to select the best language
      </td>
    </tr>

    <tr>
      <td>
        **display**\
        string, one of <code>desktop</code>, <code>mobile</code>
      </td>

      <td>
        Used to force the display type. If not provided, will switch automatically from desktop to mobile if the viewport is below 500 pixels
      </td>
    </tr>

    <tr>
      <td>
        **trackerUuid**\
        string
      </td>

      <td>
         ID identifying the package tracked on this page

        *Used by Shipup, you won't have access to this ID* 
      </td>
    </tr>

    <tr>
      <td>
        **trackingNumber**\
        string
      </td>

      <td>
        Package tracking number.

        *Used to identify a package*
      </td>
    </tr>

    <tr>
      <td>
        **orderNumber**\
        string
      </td>

      <td>
        Order number.

        *Used to identify an order*
      </td>
    </tr>

    <tr>
      <td>
        **searchEnabled**\
        boolean / string, one of: <code>true</code>, <code>false</code>
      </td>

      <td>
        Defaults to true. Enable/disable the option for customers to search for orders by email/tracking number
      </td>
    </tr>

    <tr>
      <td>
        **customerEmail**\
        string (should be used with zipCode)
      </td>

      <td>
        Email of the customer. You can use this parameter with the zipCode to bypass the search page.
      </td>
    </tr>

    <tr>
      <td>
        **zipCode**\
        string (should be used with customerEmail)
      </td>

      <td>
        Destination address zip code. You can use this parameter with the customerEmail to bypass the search page.
      </td>
    </tr>
  </tbody>
</Table>