Loading indicator: Guidelines
Loading indicators show the progress of a process for a short wait time
Usage
Loading indicators use animation to grab attention, mitigate perceived latency, and indicate that an activity is in progress.
They should be used when progress isn’t detectable, or when it’s not necessary to indicate how long an activity will take.
While similar in function to circular progress indicators, loading indicators are a better alternative for short processes between 200ms and 5s.
Choose a loading or progress indicator that corresponds to the expected wait time and type of process.
If the wait is very long, consider allowing users to navigate away from the page while the process finishes up.
| Expected wait time | Recommendation |
|---|---|
| Instant (under 200ms) | No indicator |
| Short (between 200ms and 5s) | Loading indicator |
| Long (Over 5s) | Progress indicator |
When a process can transition from indeterminate (unknown progress) to determinate (known remaining progress), transition between the corresponding progress indicators.
Don’t transition a loading indicator into a progress indicator.
Anatomy

- Active indicator
- Container (optional)
Active indicator
The active indicator is a looping shape morph sequence composed of seven unique Material 3 shapes.

Container (optional)
When the container is visible, the active indicator should change color from primary to on-primary-container.
The container should be visible when the loading indicator is placed over other content. This helps it stand out better by giving it a stronger contrast. It’s not needed when the loading indicator is placed directly on a surface.
The container should be used with pull-to-refresh behavior.

Placement
While loading a page or container, the loading indicator should be centered on the element.
When loading more items on a page with existing content, place the loading indicator in the empty space where the new content will appear. Avoid overlapping existing content.
Loading indicators can be placed within other components, such as buttons, to indicate that the action is ongoing, such as validating a form or checking for updates.
Responsive layout
Loading indicators default to 48dp, but the size is flexible. It should be between 24dp to 240dp, depending on the placement and the breakpoint. Avoid exceeding the minimum and maximum sizes.
The ratio between the container and the active indicator stays the same when resizing the loading indicator.
Reserve very large progress indicators for large and extra-large windows, like desktop.

Larger windows
As the pane or window size grows, consider scaling the loading indicator as well, so it remains proportional in size to the empty space around it. The loading indicator shouldn’t exceed 240dp.
Behavior
Pull-to-refresh
The loading indicator is used in pull-to-refresh on Jetpack Compose only.
Pull-to-refresh is an Android system feature that manually refreshes screen content with an action or gesture. It’s used at the beginning of lists, grid lists, and card collections where the most recent content appears.
It’s best to use pull-to-refresh with dynamic content that can have frequent updates, where people have a high chance of seeing new content after refreshing.
Threshold requirements
To ensure intentional usage of the pull-to-refresh gesture, the loading indicator must pass a threshold before the app will refresh.
The loading indicator remains visible until the refresh activity completes and any new content is visible, or someone navigates away from the refreshing content.