How to Customize Your Quiz Results Page

The results page is the climax of your quiz. In this article, you’ll learn how to customize the layout, display dynamic results based on user scores, and add a “Retake the Quiz” option.


Accessing the Results Page Editor

  1. Navigate to the Thrive Quiz Builder dashboard.
  2. Find the Results Page card in the Quiz Structure section.
  3. Click Manage.

  4. Click the Edit with Thrive Architect button.


Dynamic Results & Content

You can make the results page change automatically based on how the user answered.

1. Displaying the Quiz Score

To show the user their specific result:

  1. Add a Text element to your page.
  2. Highlight the text and click the Dynamic Text icon (blue person) in the toolbar.

  3. Select Quiz Shortcode > Quiz Result.

2. Displaying Category Data

If your quiz uses categories, you can go beyond showing just the winning category name. The Category Data feature lets you display individual category scores or a full ranked list of all categories on your results page.

Note: The Category Data option only appears if your quiz has categories defined. For number, percentage, and right/wrong quizzes, the shortcode modal stays the same as described above.

To access the category breakdown options:

  1. Add a Text element to your results page.
  2. Highlight the text and click the Dynamic Text icon in the toolbar.
  3. Select Quiz Shortcodes > Quiz Result.
  4. Under What to display, you’ll see two tabs: Winner (selected by default) and Category Data.

  5. Click Category Data to reveal the category options.

Option A: Single Category

This displays the score for one specific category. Use this when you want to show separate results for each category in different areas of the page.

  1. Under Scope, select Single Category (active by default).
  2. Choose a category from the Category dropdown.
  3. Choose a format from the Value Format dropdown:
    Points — The raw point value earned in that category.
    Share (%) — This category’s points as a percentage of total points across all categories.
    Percent of max (%) — This category’s points as a percentage of the maximum possible points for that category.
  4. Click Insert.

The shortcode output looks like this: 0

Note: The Insert button remains disabled until you select a category from the dropdown.

Option B: All Categories

This displays a ranked list of every category and its score. Use this when you want to give users a complete overview of their performance across all areas.

  1. Under Scope, select All Categories.
  2. Choose a format from the Value Format dropdown:
    Points — Raw point values.
    Share (%) — Each category’s share of total points.
    Percent of max (%) — Each category’s percentage of its own maximum.
  3. Under Sorting, choose how results are ordered:
    Score: High > Low (default) — Categories with the most points appear at the top.
    Score: Low < High — Categories with the fewest points appear at the top.
  4. Under Display Preferences, optionally enable the Exclude Empty Categories toggle to hide categories where the user scored zero points.
  5. Click Insert.

The shortcode output looks like this: 0

With the Exclude Empty Categories toggle enabled: 0

Shortcode Parameter Reference

Here is a quick reference for all available shortcode parameters:

  • Winner (default) — No extra parameters needed.
  • Scope: Single Categorycategory='<category name>'
  • Scope: All Categoriesshow_all_categories='true'
  • Value Format: Pointsresult_type='points'
  • Value Format: Share (%)result_type='share'
  • Value Format: Percent of max (%)result_type='percent'
  • Score: High > Lowsort_by='highest'
  • Score: Low < Highsort_by='lowest'
  • Exclude Empty Categoriesexclude_empty='true'

Things to Know

  • Switching from Category Data back to Winner hides the tabbed interface and resets all selections to their defaults.
  • Switching between the Single Category and All Categories tabs resets that tab’s controls to defaults.
  • You can place multiple shortcodes on the same results page — for example, one 0 for the winning category name plus several single-category shortcodes for a detailed breakdown below.

3. Formatting Decimals

For percentage-based quizzes, you can show a more precise score:

  • In the Dynamic Text sidebar, look for the Formatting section.
  • Enable the Display decimals toggle and set the number of decimal places (e.g., 1 or 2).

4. Using Dynamic Content Blocks

Want to show an entirely different layout for users who failed vs. those who passed?

  1. Add the Dynamic Content element to the Results Page.
  2. Create States for different score intervals (e.g., 0-50, 51-100) or categories.
  3. Design each state with unique images, text, and call-to-action buttons.

Adding a “Retake the Quiz” Button

Allowing users to try again can improve engagement.

  1. Add a Button or Text element to the Results Page.
  2. In the toolbar, click the Dynamic Link icon.
  3. Choose Thrive Quiz Builder > Retake Quiz.
  4. Click Apply.

Was this article helpful?

Related Articles

>