Customize and upgrade your Thank you and Order status pages

Note

This guide is for merchants that are on a non-Plus Shopify subscription plan. Shopify Plus merchants need to follow the Checkout Extensibility upgrade guide instead to upgrade their checkout.

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.

If you don't have any existing customizations to your checkout, then your upgrade is completed automatically without requiring any additional actions from you. If you have existing customizations to your checkout, such as additional scripts or apps that customize your Thank you or Order status pages, then you need to manually recreate your customizations using updated apps and the checkout and accounts editor, and then publish the pages to complete your upgrade.

Upgrade your Thank you and Order status pages

To upgrade 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 publishing your new 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 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 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 pixels or updated apps. To recreate visual or functional customizations made with apps, use app blocks or 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 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 checkout 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 add UI extensions that customize the appearance and functionality of your checkout pages, install a compatible app and publish it in the checkout and accounts editor.

7. Preview your changes to your checkout.

Step 4: Publish your Thank you and Order status pages

When your customizations are successfully recreated, then you must publish your Thank you and Order status pages to complete the checkout upgrade.

Steps:

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

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

3. When you’re ready to complete your upgrade, 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 Publish.

5. Click Save.

6. Confirm that customizations using deprecated features will be replaced to complete your upgrade.

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

Stores that previously created customizations with order status page additional scripts and apps with deprecated features can revert to using those customizations. To revert, go to Settings > Checkout and click Revert in the Order status page section.