Ready

Progress Bar

Progress bars communicate the working status of a user-initiated action. Progress bars support values between 0% and 100%.

Ready

Progress Bar

Progress bars communicate the working status of a user-initiated action. Progress bars support values between 0% and 100%.

Ready

Progress Bar

Progress bars communicate the working status of a user-initiated action. Progress bars support values between 0% and 100%.

States

States

States

  1. Default: Action is in progress

  2. Indeterminate: The system is currently unable to display action progress

  3. Warning: Total progress is complete but certain actions were not able to be completed

  4. Error: An error has occurred and no actions were completed

Best Practices

Best Practices

Best Practices

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.

Content

Beta

Content

Beta

Content

Beta

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.

Need more guidance?

Suggest an addition or an edit.

Need more guidance?

Suggest an addition or an edit.

Need more guidance?

Suggest an addition or an edit.

© 2025 Basis Technologies
© 2025 Basis Technologies
© 2025 Basis Technologies