Docs / Building

Ending a quiz: redirects and completion

Every quiz needs an ending. The last screen is where you send shoppers to your store, drop them at checkout with a discount, or simply close the popup. SupaPop gives you three ways to end a quiz, and it tracks each one as a completion so you can see how many people made it to the finish line.

This article covers the three endings, how to hand off to checkout with a discount, and how completions show up in your analytics.

The three ways a quiz can end

A quiz counts as completed when a visitor reaches one of these three endings:

  • A button set to Open URL (the visitor navigates to a web address).
  • A button set to Close popup (the overlay closes).
  • A Loading Screen step with a Redirect URL set (the visitor is sent on automatically after a short pause).

These are the only endings that record a completion. A form submit does not count as a completion (more on that below), and a plain “thank you” screen with no button records nothing.

How to end a quiz with a button

The most common ending is a button on your final step.

  1. Open your popup in the editor and select the last step.
  2. Add or select a Button section.
  3. In the right-hand config panel, find Button action. You have three choices:
    • Go to next step advances to the next step. This does not end the quiz.
    • Close popup ends the quiz by closing the overlay. This is the default.
    • Open URL ends the quiz by sending the visitor to a web address.
  4. If you chose Open URL, fill in the Link URL field with the destination.

That is it. When a shopper clicks the button, the quiz ends and the completion is recorded.

How to redirect from a loading screen

A Loading Screen step shows an animated transition with progress items, then sends the visitor somewhere. This is handy for “calculating your results” moments that lead straight to an offer. The Loading Screen is available in quiz mode only.

  1. Add a Loading Screen step where you want the transition.
  2. In its config panel, set Redirect URL (optional) to the destination (for example, an offer or checkout link).
  3. Set Timeout (ms) to control how long the screen shows before it moves on. The default is 2000 (two seconds). You can set it anywhere from 500 to 30000.

When a Redirect URL is set, the loader always redirects after the timeout and records a completion. The redirect always wins, so the Auto-advance after timeout checkbox only matters when there is no Redirect URL.

If you leave the Redirect URL empty and keep Auto-advance after timeout checked, the loader just moves to the next step (no completion). If you leave the Redirect URL empty and turn auto-advance off, the loader does nothing after the timeout, so do not do that unless you have another way forward.

How to hand off to checkout with a discount

A popular pattern is to end the quiz by dropping the shopper at checkout with a discount already applied.

  1. On a Loading Screen step, set the Redirect URL (or, on a button, set the Link URL) to a Shopify discount-apply link that lands the visitor in the cart or checkout, for example https://yourstore.com/discount/SAVE10?redirect=/cart.
  2. On the Loading Screen step, turn on Flush quiz answers before advancing. This saves the visitor’s answers before they leave the popup, so mid-quiz answers are not lost on the way to checkout.
  3. If you also want to show the code on screen, add a Coupon Code section and enter the discount in Coupon code. The section displays the code with an optional copy button. (The Coupon Code section only shows the code. It does not apply the discount on its own.)

You can also drop dynamic date text like {{date+30d}} into button or text section content for “expires in 30 days” style messaging. It fills in automatically when the popup is shown.

How completions show up in analytics

Your analytics dashboard has a Completion Rate tile. It shows the share of visitors who reached a terminal action (redirect, close, or checkout), counting each visitor once even if they complete more than once.

The tile also includes a per-terminal breakdown table so you can see which ending people use. The Action column labels each one as Button → URL, Button → Close, or Loader redirect. The table shows your top five endings, plus an aggregated Other terminals row when there are more than five.

The percentage is distinct completers divided by total impressions. It is not a per-view conversion rate, so a shopper who completes across two sessions still counts as one completion.

Tips

  • Always fill in the Link URL. A button set to Open URL with an empty Link URL does nothing when clicked: it will not navigate, will not close the popup, and records no completion. Fill the field every time.
  • Use full web addresses for the analytics to count. The visitor will navigate fine to a relative path like /cart, but the completion is only counted when the destination is a full address that starts with http:// or https://. Use https://yourstore.com/discount/CODE?redirect=/cart rather than /discount/CODE.
  • Flush answers before sending people to checkout. Turn on Flush quiz answers before advancing on the loader so answers are saved before the visitor leaves.
  • A plain “thank you” screen records nothing. A final screen with no button, no redirect, and no form does not count as a completion. Give it a button (Close popup or Open URL) or use a Loading Screen with a Redirect URL.
  • Editor previews do not count. Previewing your popup in the editor does not record fake completions, so test freely.

FAQ

Why is my Completion Rate tile missing? The tile is hidden when there are no completion events. Form-only popups (email or SMS capture, plain surveys) never end with one of the three terminal actions, so they show no Completion Rate tile. They use your submission and opt-in metrics instead. This is expected, not a bug.

Why doesn’t my form submit count as a completion? A form submit is not a quiz ending. The quiz engine reuses the submit signal during the quiz for each answer, so submit is deliberately left out of completion tracking. A popup whose only ending is a form submit will not appear in the Completion Rate tile. To track completion, add a button or a loader redirect to the final step.

Is dismissing the popup the same as completing it? No. If a visitor closes the popup themselves on a screen with no terminal action, that is a dismissal, which is tracked separately. Only the three endings above count as completions.