Adding additional scripts and running scripts only on first visit

Caution

This is an advanced tutorial and is not supported by Shopify. Knowledge of web design languages such as HTML, CSS, JavaScript, and Liquid is required. We suggest hiring a Shopify Partner if you are not comfortable proceeding with the following tutorial.

Note

Additional scripts to customize the order status page are deprecated.

Merchants on the Basic, Shopify, and Advanced plans can make customizations to the order status page using the checkout and accounts editor. Shopify Plus merchants can use Checkout Extensibility to customize their order status page.

You can customize your order status page by adding additional scripts. You can also set up your scripts to run only on a first visit.

Add additional scripts

Caution

This is an advanced tutorial and is not supported by Shopify. Knowledge of web design languages such as HTML, CSS, JavaScript, and Liquid is required. We suggest hiring a Shopify Partner if you are not comfortable proceeding with the following tutorial.

The Additional scripts box is used to insert code into the template for your order status page. You can add any of the following:

• HTML - You can use any valid HTML5 code, for example script, style, iframe, and object elements.

• Liquid code - You have access to the checkout and shop Liquid objects. To learn more about their attributes, refer to The checkout object and The shop object. Note that the checkout.order, checkout.order_name, and checkout.order_number values may not be present if the order creation is not yet complete. Use `checkout.order_id if you need a unique tracking id for the order that is available at all times.

Example customizations using additional scripts

Here are some example customizations that use the Additional scripts field:

• Show content when a particular shipping method is used
• Show content when a particular product is in the order
• Show content based on customers' locations
• Add a message to your order status page using a JavaScript object

Access the additional scripts

Desktop

To access additional scripts, start from your Shopify admin, and go to Settings > Checkout. Under Order status page you find the Additional scripts section.

Set up scripts to run only on a first visit

It's common to include scripts that track sales conversions on the order status page because it's the final page of checkout. However, customers who return to check their order status might count as a second sale in your analytics.

To prevent your analytics from counting customers more than once, you can add the first_time_accessed property around some or all of your additional scripts. To do this, use a Liquid if statement, and place any scripts that you only want to run once between {% if first_time_accessed %} and {% endif %} tags.

Steps:

Desktop

1. From your Shopify admin, go to Settings > Checkout.
2. In the Order status page section, go to the Additional scripts text box.
3. Paste the following code into the Additional scripts box:

{% if first_time_accessed %}
  // Conversion scripts you want to run only once
{% endif %}

  // Scripts you want to run on every visit

1. If you want a script to run the first time that the order status page is accessed, then paste it between the {% if first_time_accessed %} and {% endif %} tags. If you want a script to run every time the order status page is accessed, then paste it below the {% endif %} tag.
2. Click Save.