
Default: Action is in progress
Indeterminate: The system is currently unable to display action progress
Warning: Total progress is complete but certain actions were not able to be completed
Error: An error has occurred and no actions were completed
1. User Initiated
The progress bar is used for user-initiated actions that take longer than 1 second.¹ ² The progress bar should not be used for content loading. See Loader.

2. Multiple Actions
The progress bar should not be used to communicate the working status of multiple actions at once.

The label should be short and concise. It should describe the action being performed. Use descriptive verbs ending in -ing, and include an ellipses if the task is is progress.
When the task is complete, the label should change to reflect the new status. Use specific language that mirrors the verb used while the task was underway. For example, if the action was “Saving groups…” then the complete status could say “Save complete” or “Groups saved”.
Use sentence case--capitalize the first word. Don’t include a period.

Helper text underneath the progress bar can provide additional information, details, warnings, and so on.
![]() |
---|
This may take a while. You can close the window, and we’ll let you know when it’s finished. |
Helper text can change as the process progresses. This is useful if the amount of time it takes to complete an action can vary greatly.
![]() |
---|
0-10 seconds: This may take a few moments. 10+ seconds: This is taking longer than expected. You can close this window, and we'll notify you when it's complete. |
Related Components
Additional Reading
World Leaders in Research-Based User Experience. “Progress Indicators Make a Slow System Less Insufferable.” Nielson Norman Group, https://www.nngroup.com/articles/progress-indicators/.
Best Practices For Animated Progress Indicators https://www.smashingmagazine.com/2016/12/best-practices-for-animated-progress-indicators/
Improving the UX of Progress Indicators and Feedback Notifications https://usersnap.com/blog/progress-indicators/