Progress Bar

Use a progress bar to show users the completion status of a known process.

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 on base surface

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 composition on two surfaces

Progress bar on the base and inverted surface