Components/Feedback
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/circularprogressbar
A circular progress bar indicates the percentage of completion for a task or process with a visual indication that fills a circular track.
<Loader/> instead.Control progress bar size with size prop:
large is best for places where progress bar is the only element present.medium is for common use cases.small fits into smaller UI elements like cards and widgets.tiny is used for dense layouts.Control the appearance with skin prop. It supports 3 styles:
standard is for common cases.success is best for highligthing the positive effect of the process.premium is to prompt users to upgrade their plans to premium subscription.Invert the skin of a progress bar with the light prop. Use this skin on backgrounds with colors or images.
Add a label that indicates current progress in percentage with showProgressIndication prop.
Let users now if process failed using error property.
Add text that explains what went wrong or what action the user should take with the errorMessage prop. Message will be revealed on hover over.
Add custom label for the progress bar using label prop.
Control custom label position using labelPlacement prop:
bottom (default)centerUse circular progress bar to indicate users where they are in the feature or tool setup process.
| Name | Type | Default | Description |
|---|---|---|---|
className | string | — | Specifies a CSS class name to be appended to the component's root element. |
dataHook | string | — | Applies a data-hook HTML attribute that can be used in the tests. |
error | boolean | — | Should be true if had failure during the progress. |
errorLabel | string | — | Label to display when an error happens. |
errorMessage | string | — | Message to display when an error happens. |
label | string | — | Use to display custom text in the progress bar. |
labelPlacement | "center" | "bottom" | — | Placement of the label in the progress bar. |
light | boolean | — | Use light theme instead of dark theme. |
showProgressIndication | boolean | — | Use to display a percentage progress. |
size | "small" | "tiny" | "medium" | "large" | — | Size of the bar. |
skin | "standard" | "premium" | "success" | — | Skin of the bar. |
value | string | number | — | The number of the percentage progress. |
Import the driver matching your test environment:
| Method | Description |
|---|---|
isSuccessIconDisplayed | Checks whether the success icon is displayed |
isErrorIconDisplayed | Checks whether the error icon is displayed |
isLabelDisplayed | Checks whether the label text is displayed |
getLabelTextContent | Gets the text content displayed |
isPercentagesProgressDisplayed | Checks whether the progress percentages are displayed |
getValue | Gets the progress percentages value |
isCompleted | Checks whether the progress completed (value is 100) |
hasError | Checks whether an error occurred |
getAttribute | — |
isSingleElementRendered | — |
isErrorIconShown | Checks whether error icon is shown |
isSuccessIconShown | Checks whether success icon is shown |
getSize | Gets size. |
getTooltipErrorMessage | Gets the tooltip error message |
hasSkin | Checks whether progress bar has a given skin |
exists | Checks whether the component found with the given data hook. |
element | Gets the component root element. |
click | Clicks on the component root element. |
base | Returns UniDriver for the base element. |
wds-circular-progress-bar* ones. (#16910)tiny size variation (#13299)Last updated: 22 October 2026