---
title: Circular, Linear progress React components
components: CircularProgress, LinearProgress
githubLabel: 'component: CircularProgress'
materialDesign: https://material.io/components/progress-indicators
---

# Progress

<p class="description">Progress indicators commonly known as spinners, express an unspecified wait time or display the length of a process.</p>

Progress indicators inform users about the status of ongoing processes, such as loading an app, submitting a form, or saving updates. 

- **Determinate** indicators display how long an operation will take. 
- **Indeterminate** indicators visualize an unspecified wait time. 

The animations of the components rely on CSS as much as possible to work even before the JavaScript is loaded. 

{{"component": "modules/components/ComponentLinkHeader.js"}}

## Circular

### Circular indeterminate

{{"demo": "pages/components/progress/CircularIndeterminate.js"}}

### Circular determinate

{{"demo": "pages/components/progress/CircularDeterminate.js"}}

### Interactive integration

{{"demo": "pages/components/progress/CircularIntegration.js"}}

### Circular with label

{{"demo": "pages/components/progress/CircularWithValueLabel.js"}}

## Linear

### Linear indeterminate

{{"demo": "pages/components/progress/LinearIndeterminate.js"}}

### Linear determinate

{{"demo": "pages/components/progress/LinearDeterminate.js"}}

### Linear buffer

{{"demo": "pages/components/progress/LinearBuffer.js"}}

### Linear with label

{{"demo": "pages/components/progress/LinearWithValueLabel.js"}}

## Non-standard ranges

The progress components accept a value in the range 0 - 100.  This simplifies things for screen-reader users, where these are the default min / max values.  Sometimes, however, you might be working with a data source where the values fall outside this range.  Here's how you can easily transform a value in any range to a scale of 0 - 100:

```jsx
// MIN = Minimum expected value
// MAX = Maximium expected value
// Function to normalise the values (MIN / MAX could be integrated)
const normalise = (value) => ((value - MIN) * 100) / (MAX - MIN);

// Example component that utilizes the `normalise` function at the point of render. 
function Progress(props) {
  return (
    <React. Fragment>
      <CircularProgress variant="determinate" value={normalise(props.value)} />
      <LinearProgress variant="determinate" value={normalise(props.value)} />
    </React. Fragment>
  );
}
```

## Customized progress

Here are some examples of customizing the component.  You can learn more about this in the
[overrides documentation page](/customization/components/). 

{{"demo": "pages/components/progress/CustomizedProgressBars.js", "defaultCodeOpen": false}}

## Delaying appearance

There are [3 important limits](https://www.nngroup.com/articles/response-times-3-important-limits/) to know around response time. 
The ripple effect of the `ButtonBase` component ensures that the user feels that the system is reacting instantaneously. 
Normally, no special feedback is necessary during delays of more than 0.1 but less than 1.0 second. 
After 1.0 second, you can display a loader to keep user's flow of thought uninterrupted. 

{{"demo": "pages/components/progress/DelayingAppearance.js"}}

## Limitations

### High CPU load

Under heavy load, you might lose the stroke dash animation or see random `CircularProgress` ring widths. 
You should run processor intensive operations in a web worker or by batch in order not to block the main rendering thread. 

![ heavy load](/static/images/progress/heavy-load.gif)

When it's not possible, you can leverage the `disableShrink` prop to mitigate the issue. 
See [this issue](https://github.com/mui-org/material-ui/issues/10327). 

{{"demo": "pages/components/progress/CircularUnderLoad.js"}}

### High frequency updates

The `LinearProgress` uses a transition on the CSS transform property to provide a smooth update between different values. 
The default transition duration is 200ms. 
In the event a parent component updates the `value` prop too quickly, you will at least experience a 200ms delay between the re-render and the progress bar fully updated. 

If you need to perform 30 re-renders per second or more, we recommend disabling the transition:

```css
.MuiLinearProgress-bar {
  transition: none;
}
```
