Docs / Integrations

Setting up the post-purchase survey on your thank-you page

A post-purchase survey is a short SupaPop survey that appears on your Shopify thank-you page, the order confirmation screen a customer sees right after they finish checkout. It is a great place to ask “How did you hear about us?” or to collect quick feedback, because the customer just bought and is paying attention. SupaPop ties each response to the order automatically, so you do not have to match responses to orders by hand.

Setting this up takes two parts, and both are required. First, you build a survey in SupaPop and set it to post-purchase. Second, you add the SupaPop block to your thank-you page in Shopify. If you only do one of the two, the survey will not show, and you will not get an error. This guide walks through both.

Before you start

  • Your store must be on Shopify’s newer checkout. The thank-you page block only works on stores using checkout extensibility. Many stores moved to this after the August 2025 migration, and Shopify Plus stores already have it. If your store is still on the older order status page, the block may not be available.
  • You need Shopify admin permission for Checkout to place the block. If you do not have it, you can still build the survey in SupaPop, but you will need to send the placement link to your store admin to finish.
  • The fastest start is the ready-made template. In SupaPop, create a new popup and pick the Post-Purchase Survey template. It comes with two questions and is already set to post-purchase delivery, so you can skip some of the setup below.

How to build the survey in SupaPop

  1. Create a new popup, or open an existing one in the editor.
  2. Open the Popup Container settings.
  3. Find the Delivery channel setting and choose “Post-purchase (Shopify thank-you page)”. This tells SupaPop to serve the survey on the thank-you page instead of your storefront.
  4. Notice that the display mode switches to embed automatically. This is on purpose. Shopify does not allow overlay popups on the thank-you page, so the survey renders inline on the page.
  5. Build your survey using the supported sections only: Text, Answer Choice, and Button. Other section types do not render on the thank-you page (they are for storefront popups), so do not use them here. If you try to save a post-purchase survey that still contains an unsupported section, SupaPop shows a validation error telling you which section to remove.
  6. Save your work.

Only one post-purchase survey runs at a time per store. If more than one is live and set to post-purchase, SupaPop shows the one you updated most recently.

How to add the block in Shopify

The survey will not show to customers until you place the SupaPop block on your thank-you page. SupaPop cannot do this step for you, because Shopify controls the thank-you page layout.

  1. Open your post-purchase survey in SupaPop and click Go live. Instead of going live right away, SupaPop opens a short dialog titled “Before going live: place the SupaPop block” with the placement steps. This is a safeguard so you do not launch a survey that collects nothing.
  2. Open the Shopify Checkout Editor. The dashboard gives you a direct link (the “Preview in Thank you page editor” button, or the “Open Checkout Editor” link in the reminder banner). In Shopify, this lives under your checkout customization settings.
  3. At the top of the editor, make sure the page selector reads “Thank you”.
  4. In the sidebar, click “Add app block”.
  5. From the list, pick “post-purchase-survey”. This is the exact name you are looking for, so search for it if the list is long.
  6. Drag the block to where you want it on the page, then click “Save”.
  7. Back in SupaPop, confirm that you have placed the block so the survey goes live.

How to confirm it is working

The thank-you page survey does not appear through the normal storefront preview link. To check it, do one of these:

  • Use the “Preview in Thank you page editor” button on your dashboard, which opens the Shopify Checkout Editor where you placed the block.
  • Place a real test order and view your own thank-you page.

When everything is set, your survey shows inline on the page. SupaPop ties each response to the order on its own, so you do not need to ask for an order number.

Tips

  • Both steps are mandatory. A live post-purchase survey with no block placed, or a placed block with no live survey, both result in zero responses and no warning.
  • If the block is placed but no live post-purchase survey exists, the page shows a short “No post-purchase survey configured” message to anyone who reaches it, including real customers. Finish both steps before you send buyers through checkout.
  • Keep your sections to Text, Answer Choice, and Button. Other section types do not render on the thank-you page.
  • If a teammate without Checkout permission is doing setup, send them the Checkout Editor link from your dashboard so a store admin can place the block.

Troubleshooting

The survey does not appear on my thank-you page. Check both halves. In SupaPop, confirm the survey is live and its delivery channel is set to post-purchase. In Shopify, confirm the “post-purchase-survey” block is placed on the Thank you page and saved.

I see a “No post-purchase survey configured” message. The block is placed, but there is no live post-purchase survey. In SupaPop, create or open a survey, set its delivery channel to post-purchase, and click Go live.

I cannot place the block. Placing it needs Shopify admin permission for Checkout. Forward the Checkout Editor link to your store admin to finish.

My store does not show the block option. Your thank-you page may still be on Shopify’s older checkout. The block needs the newer checkout extensibility, so an older store may not support it.