Non-Plus - Customize and replace your Thank you and Order status pages

Note

This guide is for merchants with stores that are on a non-Plus Shopify subscription plan. Stores on the Shopify Plus plan need to follow the Shopify Plus customization guide instead.

You can use Shopify Checkout to accept orders and receive payments wherever you sell online. With the checkout and accounts editor, you can customize your Thank you and Order status pages in a way that's compatible with future upgrades and works with Shop Pay.

Shopify is moving to a new foundation for checkout and accounts that's more secure, upgrade-safe, and lets you customize with app blocks and web pixels. If you currently use additional scripts or apps to customize your Thank you or Order status pages, then you need to manually recreate your customizations with app blocks in the checkout and accounts editor or web pixels in Customer events.

When you’re ready, you can replace your Thank you and Order status pages in order to publish your customizations on the new versions of these pages.

About the Thank you and Order status pages

The Thank you and Order status pages are pages that display in the Shopify Checkout when a customer has completed a purchase.

Thank you page

The Thank you page is displayed to customers after they complete checkout, and is a one-time page that the customer can't access again. It provides confirmation of the order and confirms that the checkout was successful. It displays a confirmation number instead of an order number.

Order status page

After an order is created in Shopify, the customer receives an order confirmation notification. The order confirmation links to the Order status page. Several order notifications, such as shipping notifications, link to the Order status page by default. The Order status page can be bookmarked and revisited by the customer multiple times to access shipping updates and order details.

Learn more about the order status page.

Customizing and replacing your Thank you and Order status pages

To customize and replace your Thank you and Order status pages, you need to complete the following steps:

1. Review your existing additional scripts customizations.
2. Review your list of installed apps that customize your Thank you and Order status pages.
3. Recreate your checkout customizations.
4. Complete the upgrade by replacing your Thank you and Order status pages.

Step 1: Review your existing order status page additional scripts customizations

To review existing customizations created with the order status page's additional scripts, access your personalized report.

Steps:

1. From your Shopify admin, go to Settings > Checkout.

2. In the Configurations section, click Review customizations.

3. In the Customizations report page, you'll receive an analysis of your additional scripts, including the following data:

   • Category of customization, such as Conversion Pixels or Order tracking
   • Customization name and description
   • Source file, such as additional scripts
   • Guidance for recreating the customization in the checkout and accounts editor

Step 2: Review your existing customizations created with apps

To continue using Thank you and Order status page customizations created with apps, an app must be updated by the app developer so you can recreate customizations using app blocks and web pixels. For apps that have been updated by the app developer, you can follow their setup instructions to get started. You can contact the app developer about apps that still require an update and aren't yet ready for you to set up.

Learn more about customizing your checkout and accounts with apps.

Steps:

1. From your Shopify admin, go to Settings > Checkout.

2. In the Configurations section, click Review customizations.

3. In the Customizations report page, you'll receive a list of apps divided into the following types:

   • Apps that have been updated by the app developer and are ready for you to set up and recreate your customizations.
   • Apps that require an update by the app developer before you can set them up and recreate your customizations. You can contact the app developer directly for more information.

Step 3: Recreate your customizations

How you recreate your customizations depends on what kind of previous customizations you made to your Thank you and Order status pages.

To recreate existing customizations made with order status page additional scripts, use web pixels or updated apps. To recreate visual or functional customizations made with apps, use app blocks or web pixels. Open your existing Thank you and Order status page customization apps to access instructions for creating customizations using these compatible features.

If an app hasn't been updated to offer compatible customization features using app blocks or web pixels, then contact the app developer or install an alternate app.

Steps:

1. From your Shopify admin, go to Settings > Checkout.

2. In the Configurations section, click Customize next to the configuration that you want to customize.

3. In the checkout and accounts editor, click the gear icon to access the Settings sidebar.

4. Customize the style of your checkout using the checkout and accounts editor.

5. To re-add tracking pixels to your pages, use app or custom pixels. Follow the steps to migrate your old tracking pixels to either an app pixel or a custom pixel.

6. To customize the appearance and functionality of your Thank you and Order status pages, install a compatible app and save it in the checkout and accounts editor.

7. Preview your changes to your Thank you and Order status pages.

Step 4: Replace your Thank you and Order status pages to publish your customizations

When your customizations are successfully recreated, then you must replace your Thank you and Order status pages to publish your new customizations.

Steps:

1. From your Shopify admin, go to Settings > Checkout.

2. In the Configurations section, click Customize next to the configuration that you want to customize.

3. Navigate to the Thank you or Order status page in the checkout and accounts editor using the page selector.

4. Click the sections icon to open the Sections sidebar, and then click Replace pages.

5. Confirm that customizations using deprecated features will be replaced to complete your upgrade. You can revert if needed.

Optional: Revert your Thank you and Order status pages to use additional scripts and apps with deprecated features

Stores that previously created customizations with Order status page additional scripts and apps with deprecated features can revert to using those customizations. This is only possible when the Thank you and Order status pages previously had customizations that used checkout.liquid, additional scripts, or apps that use script tags.

Steps:

1. From your Shopify admin, go to Settings > Checkout.

2. In the Order status page additional scripts section, click the revert link.

3. Select the pages that you want to revert, and then click revert.

After you revert, your customizations made with app blocks and web pixels are saved as a draft configuration that you can update and publish again later.