Loader

Components/Feedback

Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/loader

Overview

Copy

Loader is used to show users when an action is being processed.

Do

  • Use to show that the requested action has started and will be completed soon, like changes on a page being saved.
  • Use when task completion time is unknown.
  • Place in the vertical and horizontal center of a layout.

Don't

  • Don't use for an initial load of page content when you know how the final result will look. Use <Skeleton/> instead.
  • Don't use for processes that have a detected completion time or require a long time to complete. Use <CircularProgressBar/> or <LinearProgressBar/> instead.
  • Don't show multiple loaders on the page at a time. Use <Skeleton/> instead.

Feature examples

Size

Adjust loader size using the size prop. It supports 4 sizes:

  • large - use for a full page, like when saving applied changes.
  • medium (default) - use for a specific area inside of a page.
  • small - use in larger components, like a table or a modal.
  • tiny - use in smaller components, like a button.
Copy

Color

Change the colors of the loader circle with the color prop. There are 2 color options:

  • blue (default) - use on white and light grey backgrounds.
  • white - use on dark backgrounds.
Copy

Status

status defines the current state of the Loader indicator.

  • loading: shows an active loading state.
  • success: shows a successful completion state.
  • error: shows a failed/error state.
Copy

Status message

Show the process status using the statusMessage prop. The message is displayed when a user mouse hovers over the loader.

Note: users navigating with a keyboard will not be able to see the message.

Copy

Text

Add a descriptive label below a loader with the text prop. Use it to explain what is happening when additional info is required.

Copy

Common use case examples

Load more items

Use loader to indicate that more items are being loaded to a list as a user scrolls down a component or layout, e.g., inside a <Table/>.

Copy

Triggered action in process

Add a loader inside of a <Button/> to inform users that the action has started and is currently being processed.

Copy

Save page changes

Use a loader to indicate that changes a user made on the page are being saved.

Copy

Code

Copy

Props

NameTypeDefaultDescription
color"blue" | "white"—Controls the skin of the loader.
dataHookstring—Applies a data-hook HTML attribute to be used in the tests.
size"small" | "tiny" | "medium" | "large"—Controls the size of the loader.
status"error" | "loading" | "success" | "loadingWithErrors"—Specifies the status of a loader.
statusMessagestring—Defines the message that explains the current status of the loader. The message is displayed on loader hover. If not given or empty, no tooltip is displayed.
textReactNode—Defines a text message to show below the loader.

Testkit

Import the driver matching your test environment:

Copy

Driver methods

MethodDescription
component—
getColorreturns the loader color ('blue' or 'white')
getTextreturns the element text
hasTexttrue if the element has text
statusIndicatorExiststrue if the status indicator is rendered
isLargetrue when using the large loader
isMediumtrue when using the medium loader
isSmalltrue when using the small loader
isTinytrue when using the tiny loader
isLoadingtrue when loader is in loading status
isLoadingWithErrorstrue when loader is in loading-with-errors status
isErrortrue when loader is in error status
isSuccesstrue when loader is in success status
getStatusMessagetrigger the tooltip and returns the value of the tooltip message (async function)
existsChecks whether the component found with the given data hook.
elementGets the component root element.
clickClicks on the component root element.
baseReturns UniDriver for the base element.

Changelog

  • 1.339.0 (2026-10-19) — maintenance release, no component-specific changes
  • 1.338.0 (2026-10-15) — maintenance release, no component-specific changes
  • 1.336.0 (2026-10-13) — maintenance release, no component-specific changes
  • 1.330.3 (2026-09-29) — maintenance release, no component-specific changes
  • 1.329.0 (2026-09-24) — maintenance release, no component-specific changes
  • 1.328.0 (2026-09-22) — maintenance release, no component-specific changes
  • 1.325.0 (2026-09-17) — maintenance release, no component-specific changes
  • 1.322.0 (2026-09-09) — maintenance release, no component-specific changes
  • 1.310.0 (2026-08-10) — maintenance release, no component-specific changes
  • 1.292.0 (2026-06-22) — maintenance release, no component-specific changes
  • 1.278.0 (2026-05-08) — maintenance release, no component-specific changes
  • 1.269.0 (2026-04-15) — feat: add loadingWithErrors status (#16130) — has visual changes
  • 1.266.0 (2026-04-07) — maintenance release, no component-specific changes
  • 1.260.1 (2026-03-23) — maintenance release, no component-specific changes
  • 1.260.0 (2026-03-17) — maintenance release, no component-specific changes
  • 1.256.3 (2026-02-17) — maintenance release, no component-specific changes
  • 1.248.0 (2026-01-23) — fix: update loader-fill-default to standard-tertiary-readonly (#15837)
  • 1.228.0 (2025-11-18) — maintenance release, no component-specific changes
  • 1.212.0 (2025-08-11) — maintenance release, no component-specific changes
  • 1.169.0 (2025-03-10) — maintenance release, no component-specific changes
  • 1.127.0 (2024-09-12) — breaking: tokenize (#14093)
  • 1.115.0 (2024-07-17) — maintenance release, no component-specific changes
  • 1.102.0 (2024-04-16) — maintenance release, no component-specific changes
  • 1.97.2 (2024-03-04) — maintenance release, no component-specific changes
  • 1.93.0 (2024-02-08) — maintenance release, no component-specific changes
  • 1.92.1 (2024-02-05) — maintenance release, no component-specific changes

Last updated: 21 October 2026

Did this help?