Skip to content

Skeleton vs Spinner vs Progress Bar: Types of Loading and Feedback States

Skeletons, spinners, progress bars, toasts, banners, status badges and empty states: which feedback pattern fits each wait or message, with live React examples.

By , MiniDev6 min read

Feedback is how an interface tells people it heard them. Without it, they click again, refresh, or leave. With the wrong kind, a spinner over a whole page or a toast for an error, the product feels slow or confusing even when it is not. This guide covers the loading and feedback patterns used in web apps, when each fits, and a live example of each from MiniDev UI.

Feedback picker

SituationUseAvoid
Content loading, layout knownSkeletonA page-sized spinner
A short action under 2 to 3 secondsSpinner in the buttonBlocking the whole page
A long job with measurable progressProgress barAn endless spinner
An action succeeded or can be undoneToastA modal
A state that persists: offline, trial endingBannerA toast that vanishes
The state of a recordStatus badgeColour alone
No data yet, or no resultsEmpty stateA blank area
A risky action needs a decisionAlert dialogA toast

Loading indicators

Skeleton

A skeleton is a grey placeholder in the shape of the content that is about to appear: lines for text, a circle for an avatar, a block for an image. The layout stays still, so the page does not jump when the data arrives, and the wait feels shorter because people can already see what is coming.

Best for: first loads of pages, lists, cards and dashboards where the layout is known. Avoid when: the wait is under about 300 ms; a flash of skeleton is worse than nothing. And avoid skeletons that do not match the real layout, because the jump defeats the point. Tip: a gentle shimmer signals activity; respect reduced motion by keeping it still.

Loading the live Skeleton…
SkeletonA card placeholder in the shape of the real card.Docs

Spinner

A spinner says something is happening without saying how long it will take. It is the right size of feedback for short, bounded waits.

Best for: saving, submitting, refreshing one panel, anything that takes a second or two. Put it where the action happened, usually inside the button. Avoid when: the wait is long or measurable (use progress) or the content has a known shape (use a skeleton). Tip: disable the button while the spinner runs so the action cannot fire twice, and keep the button the same width.

Loading the live Spinner…
SpinnerA spinner inside the button that started the action.Docs

Progress bar

A progress bar fills as a job advances, ideally with a percentage or a count such as 34 of 120 files. Knowing how much is left is what makes a long wait tolerable.

Best for: uploads, imports, exports, multi-step processing, onboarding completion. Avoid when: you cannot measure progress; a bar that sits at 99% destroys trust faster than a spinner. Tip: for jobs over 10 seconds, let people leave and notify them when it finishes.

Loading the live Progress…
ProgressA simulated upload with a percentage.Docs

Messages and status

Toast

A toast is a short message that appears in a corner after an action, confirms what happened, and disappears on its own. It is feedback, not a conversation.

Best for: Saved, Invoice sent, Link copied, and Undo after reversible actions such as archiving. Avoid when: the message is an error that needs action, a form validation message, or something people must not miss. Tip: past tense, one line, and keep it on screen at least 5 seconds when it has a button.

Loading the live Toast…
ToastSuccess, warning and error tones.Docs

A banner is a full-width message at the top of the page or a section that stays until the situation changes or it is dismissed. Use it for states, not events.

Best for: you are offline, your trial ends in 3 days, scheduled maintenance tonight, an incident in progress. Avoid when: the message is about one action that just happened; use a toast. Tip: one banner at a time, with one clear action such as Upgrade or Retry.

Loading the live Banner…
BannerA banner with an action and a dismiss button.Docs

Status badge

A status badge is a small pill that labels the state of a record: Paid, Overdue, Draft, Live, Failed. In tables it lets people scan hundreds of rows for the ones that need attention.

Best for: invoices, orders, deployments, tickets, any record with a lifecycle. Avoid when: the badge is decorative; if every row is Active, the badge adds nothing. Tip: use a word and a colour together, and keep the set of states small and consistent across the product.

Loading the live Status Badge…
Status BadgeStatus badges in a table.Docs

Alert dialog

An alert dialog stops everything to ask a question that cannot wait, usually before something destructive. It is the strongest feedback there is, so it should be the rarest.

Best for: deleting data, discarding unsaved changes, irreversible payments. Avoid when: the action can be undone; act and offer Undo in a toast instead. Tip: name the consequence in the title and repeat the verb on the button.

Loading the live Alert Dialog…
Alert DialogA confirm button that waits for the async action.Docs

When there is nothing to show

Empty state

An empty state fills the space where content will be: a new account with no projects, a search with no results, an inbox at zero. It is one of the most viewed screens in any product, because every new user sees it first.

Best for: first use, no search results, cleared lists, and errors where nothing loaded. Avoid when: never leave a blank area instead. Tip: say why it is empty in one line, and give the one action that fills it: Create your first project, Clear filters, Try again.

Loading the live Empty State…
Empty StateAn empty state with one clear action.Docs
Loading the live Empty State…
Empty StateNo search results, with a way out.Docs

How long is too long? Timing rules

WaitWhat people feelWhat to show
Under 100 msInstantNothing, just the result
100 ms to 1 sA small delayNothing, or a subtle pressed state
1 to 3 sWaitingA spinner where the action happened, or a skeleton
3 to 10 sGetting impatientA skeleton or progress, plus a short label
Over 10 sLeavingProgress with a percentage, and let them leave and get notified

Optimistic updates beat any loading indicator: show the result immediately (the message sent, the task ticked) and roll back with an error toast in the rare case the server fails.

Accessibility for feedback

  • Announce toasts and status changes with an ARIA live region (aria-live="polite", or assertive for errors).
  • Mark loading regions with aria-busy="true" and give spinners a text label such as Loading invoices.
  • Progress bars use role="progressbar" with the current value and maximum.
  • Respect prefers-reduced-motion: stop shimmer and spinning, keep a static indicator.
  • Never use colour alone for status; pair it with a word or icon.

Every pattern above is a free, MIT-licensed React component. Install one with npx shadcn@latest add @minidev/skeleton, and read the empty states and skeletons guide for a full worked example.

Components used in this guide

Frequently asked questions

Should I use a skeleton or a spinner?

Use a skeleton when content is loading and you know its layout, such as a list or a card, so the page does not jump. Use a spinner for short actions like saving, placed where the action happened.

When should I use a progress bar instead of a spinner?

When the job takes more than a few seconds and you can measure how far it has got, such as uploads, imports and exports. If you cannot measure progress, use a spinner with a label instead of a fake bar.

What is the difference between a toast and a banner?

A toast reports an event that just happened and disappears on its own. A banner describes a state that persists, such as being offline or a trial ending, and stays until the state changes or it is dismissed.

What should an empty state include?

One line on why it is empty, and the one action that fills it: create the first item, clear the filters, or try again. An illustration is optional; the action is not.

How long can a loading state last?

Under a second, show nothing special. One to three seconds, a spinner or skeleton. Over ten seconds, show real progress and let people leave and be notified when the job finishes.

Do skeleton screens make pages feel faster?

Yes, when they match the final layout. People see the structure immediately, so the wait feels shorter and the page does not jump. A skeleton that does not match the real layout loses that benefit.

More guides