Use progress bars to:
- Show progress for processes where the total duration or completion percentage is known
- Provide visual feedback for file uploads, downloads, or data processing
- Display progress for tasks that take longer than one second
Do not use progress bars:
- When the process duration is unknown or indeterminate, use a spinner instead
- For processes that complete in less than one second, no indicator is needed
- For multi-step processes where each step needs to be shown — use the process steps component instead
- As a decorative element without an actual process to track
- Without a label to provide context and the information on the progress completed
Progress bar component
Context and labelling
The typical use case for a progress bar is when the length of a process is known. The bar works best with text indicating the percentage and, optionally, a label describing the process type.
Progress bars are commonly displayed with:
- A label explaining the process (e.g., "Uploading document")
- A value showing completion (e.g., percentages, time remaining)
What is essential is that a final value is known. This allows users to understand how much of the process remains.
Progress bar on the base and inverted surface