For the complete documentation index, see llms.txt. This page is also available as Markdown.

Activating Zigpoll on Shopify Checkout Extensions

Add the Zigpoll app block in Shopify's checkout editor so surveys appear on the Thank You and Order Status pages

Shopify's Thank You and Order Status pages now use Checkout Extensibility. These pages don't run scripts from apps. For a Zigpoll survey to appear on them, or on customer account pages, add the Zigpoll app block in Shopify's checkout editor.

The app block is a separate install from the theme App Embed, which runs storefront surveys. A store that shows on-site surveys still needs the app block before post-purchase surveys appear. See Shopify App.

Zigpoll's Shopify delivery templates are named after the pages in the checkout editor, so you can match each survey to the page that needs the app block:

Zigpoll delivery template
Shopify editor page(s)
Plan

Thank You & Order Status

Thank you, Order status

All plans

Order Status Only

Order status

All plans

Checkout Steps

Information, Shipping, Payment

Shopify Plus

Customer Accounts

Orders, Profile (customer accounts editor)

All plans

Upgrading your Thank You and Order Status pages

Shopify retired the old Thank You and Order Status pages. Shopify's deadline for merchants to upgrade was August 26, 2026. On upgraded stores, anything added through Order status page additional scripts no longer runs. That includes the older Zigpoll embed code, so a post-purchase survey that relied on it stops appearing.

Shopify's own guide covers the upgrade: Upgrading to Checkout Extensibility.

If your survey stopped collecting responses after a date and nothing changed in Zigpoll, check whether your store upgraded these pages around that date.

Add the Zigpoll app block

  1. Install the Zigpoll app from the Shopify App Store.

  2. In Shopify admin, go to Settings → Checkout → Customize.

  3. Select Thank you from the page dropdown at the top of the editor.

  4. Click Add app block and select Zigpoll.

  5. Drag the block to where you want the survey to appear. Higher on the page is seen by more buyers.

  6. Click Save.

  7. Select Order status from the page dropdown and repeat steps 4–6.

When you create your first Thank You & Order Status survey, the Zigpoll dashboard shows an Open checkout editor button that takes you straight to this screen in your Shopify admin.

You can still manage all of your surveys from the Zigpoll dashboard. You don't need to change the block when you edit a survey or swap which survey is live.

Choosing which survey the block shows

The block doesn't store a survey. Each time the page loads, Zigpoll serves the first live survey whose delivery template matches that page. A survey using Thank You & Order Status shows on both pages, and Order Status Only shows on Order status alone.

To change which survey buyers see:

  1. In Zigpoll, open the survey and go to Settings → Delivery → Format. Choose an on-site or page embed format. Link, email and SMS formats never appear in a checkout block.

  2. Open the Locations tab, click Use a Template, and pick Thank You & Order Status or Order Status Only. Click Save Changes.

  3. Make sure the survey is Live. Hidden and archived surveys are never served to buyers.

  4. If more than one live survey uses the same template, hide the ones you don't want showing.

The Preview survey setting

Click the Zigpoll block in the checkout editor to see its settings. Preview survey (optional) changes only what you see inside the editor. Buyers always see the survey your dashboard serves.

Preview survey value
What the editor shows

Not set

Your first live survey for that page. If none is live, a Zigpoll sample survey appears.

My Active Survey

Your first live survey for that page. If none is live, the block is empty.

A named survey, such as NPS Survey

Zigpoll's sample survey of that name, not one of your own.

An empty editor preview with My Active Survey selected means no live survey matches that page. A sample survey in the editor is not a sign the block is broken.

The block's other settings adjust copy size, colors and buttons. See Shopify Checkout Limits for what they control and why your Zigpoll Design settings don't apply here.

Thank You page vs. Order Status page

The Thank You page appears once, right after purchase. The Order Status page stays available to your customer, from the order confirmation email or their account, long after the order.

  • A response dated weeks after the order usually came from the Order Status page.

  • To collect answers only at the moment of purchase, remove the Zigpoll block from the Order status page in the checkout editor and keep it on Thank you.

Checkout Steps Surveys (Checkout Survey block)

In addition to the Thank You and Order Status pages, the Checkout Steps delivery template shows a survey during checkout itself, before the order is placed. To add it:

  1. Open the checkout editor.

  2. Select the Information, Shipping, or Payment page from the dropdown (or Checkout if you use the one-page layout).

  3. Add the Checkout Survey app block.

Block Checkout (require the survey before continuing). The Checkout Survey block can require buyers to complete the survey before they continue checkout. This is a double opt-in. It only takes effect when Block Checkout is enabled in both places:

  1. In the checkout editor, on the Checkout Survey block's settings, enable Block Checkout.

  2. In the Zigpoll dashboard, on the survey's Delivery settings, enable Block Checkout.

When the checkout editor setting is on, checkout stays closed while the survey loads, so buyers can't slip past during the brief loading window. If checkout appears stuck for buyers, check that both toggles are set the way you intend.

Customer Account Surveys

The Customer Accounts delivery template uses the Customer Account Survey block for the new customer accounts experience (profile and order pages). To add it:

  1. In your Shopify admin, go to Settings → Customer accounts → Customize.

  2. Add the Zigpoll app block to the profile or order index page.

  3. Click Save.

What the checkout can't do

Shopify's checkout sandbox rules out pop-ups, custom fonts and your Zigpoll Design settings on these pages. It also rules out traffic source data and exit intent.

Shopify Checkout Limits

Survey still not showing?

Work through the checkout section of the troubleshooting guide:

Why Is My Survey Not Showing?

If you have questions about the checkout extension, or about Zigpoll in general, get in touch.

Legacy Post Purchase Installation

Last updated