Configure Progress Bar

The progress bar appears at the top of question screens (on Centered layout) and shows the user how far through the flow they are. It is auto-calculated from the question ordering, but you can customize it with named sections.

How the progress bar works

By default, the progress bar calculates progress as: (current question index) / (total number of visible questions). It automatically excludes questions that do not count toward progress:

Blockers
Processing screens
Quote pages
Redirect screens
Success screens

Adding named sections

To show labeled sections (e.g., “Personal Info”, “Coverage”, “Payment”), configure the progressBar field in the questionnaire metadata:

Open your questionnaire in Strapi
In the metadata section, find progressBar
Add entries — each entry defines a section:

Field	Purpose	Example
initialQuestionId	The first questionId in this section	`dateOfBirth`
title	The label shown to the user	`Personal Info`

Example configuration

initialQuestionId	title
`intro`	`Get Started`
`dateOfBirth`	`Personal Info`
`coverageStartDate`	`Coverage`
`checkout`	`Payment`

The progress bar will show four sections. As the user advances past each initialQuestionId, the corresponding section is marked as active.

Tips

Order matters — Sections should follow the natural question ordering
Not every question needs a section — Only define sections at meaningful transition points
Sections are visual only — They do not affect navigation or rules
Standalone questions ignore the progress bar — Questions with layout: Standalone (blockers, success screens) do not show the progress bar regardless of configuration