Create multi-page extensions

In this tutorial, you'll learn how to create a checkout UI extension that can render in checkout, the Thank you page, the Order status page, or all three areas.

• You're familiar with Thank you and Order status extensions.

• You've created a Partner account.

• You've created a new development store with the following:

  • Generated test data
  • Checkout and Customer Accounts Extensibility developer preview enabled

• You've created an app that uses Shopify CLI 3.0 or higher.

You can use a checkout UI extension to add custom content across multiple pages of checkout.

Depending on the page and state of Shopify’s internal order processing, the targets and APIs available to extensions can vary.

A multi-page extension can be used to add custom content such as final sale details, upsells, surveys and more. The following examples demonstrate how to use targets to target different parts of the flow, depending on your use case.

You can configure an extension to display before a purchase is completed by using the purchase.checkout.cart-line-item.render-after target. This means that merchants can place the extension on the information, payment and shipping steps of checkout (pre-purchase).

You can configure an extension to display after a purchase is completed by using both the purchase.thank-you.cart-line-item.render-after and customer-account.order-status.cart-line-item.render-after targets. This means that merchants can place the extension on the Thank you and Order status pages (post-purchase).

You can configure an extension to display on all areas of the checkout flow by combining the purchase.checkout.cart-line-item.render-after, purchase.thank-you.cart-line-item.render-after and customer-account.order-status.cart-line-item.render-after targets.

1. Follow the guide to test an extension in the editor
2. Use the dropdown list at the top of the page to navigate to the Thank you and Order status pages.