Loading Spinner

An animated element that indicates loading is in process and where it will appear when loading data is slow.

Also known as:
SpinnerLoaderProgress indicatorsCircular indicatorsIndeterminate indicators

AnchorNeed to know

  • Center the loading spinner in the available space.
  • Avoid showing multiple Loading Spinners on a single page.
  • Give people an idea of what’s happening when a small content/data item takes less than 10s to load.

UI Kit

To keep in mind

A loading spinner is generally a branded element with a looping animation that indicates loading is in process and where it will appear.

  • Avoid showing multiple loading spinners on a single page. For example, in a list, you might show one loading spinner for the entire group of items instead of a loading spinner for each item in the list.
  • The loading spinner accessibility label needs to describe the state of the loading element e.g. “Loading”, “Saving”, “Processing” and, where appropriate, the object e.g. “Loading comments”.
  • You might avoid “jank” using CSS animations.

Learn more about loading patterns.

When to use and when not to use

When to use
  • For a tiny, inline action or feedback, e.g. clicked a button and the action will take time.
  • For fast processes that take less than 300ms, consider a spinner or no loading state at all.
  • When data takes less than 10s to load on an average connection for our user base.
  • For low-traffic pages such as super-user only admin pages.
When not to use
  • When there’s more than 1 element loading, use a loading skeleton instead.
  • For a long-running process or background process, e.g. importing data or exporting reports, use a progress bar (link to come) instead.
  • For high-traffic pages like our account dashboard, use a loading skeleton.
  • For introducing content with flair, use a choreographed or stylized entrance. In contrast to a placeholder loading skeleton, choreographed or stylized entrances don’t care how long content takes to load. For example, the whole page might be loaded already, but we only reveal each section with a fade as the person scrolls down the page. A single stylized entrance may mask and replace a loading spinner.

External links