Progress bar
A labeled bar that shows how far along something is.
Use this element#
Existing Progress bar elements expose a percentage from 0 to 100 and a choice to show the number on the bar. Edit the label to explain what the percentage represents.
This element is currently not offered for new insertion. A displayed percentage is authored content, not a live measurement. Do not use it as a payment or upload status indicator.
Availability#
Not offered for adding in the default 0.9.13 catalog. Existing instances keep their settings and public behavior. A site may explicitly change the catalog through the supported filter.
Content controls#
These are the controls registered for this element. A control that depends on another setting or the surrounding layout appears only when it applies.
Label#
Input type: text. The words above the bar (0.9.15 and later). The bar's accessible name follows them.
Percentage#
Input type: number. Enter the desired value, then check the page result.
Min: 0; Max: 100; Step: 1.
From 0.9.15 the bar fills to exactly its percentage: 0% is empty, and a very low value has no minimum fill, so a number shown on a short fill can be cut off.
Show the percentage on the bar#
Turn this option on or off. The label describes the behavior being enabled.
Style controls#
In Developer mode, Style starts with this element's own group, Progress bar, open above the shared Style groups (available in 0.9.15 and later):
| Control | Value |
|---|---|
| Bar thickness | Size in px, rem or em |
| Fill color | Color |
| Track color | Color |
| Percentage color | Color |
| Corner radius | Size in px, rem or em |
Each works like the rest of the inspector: it starts by showing the element's current look, Reset brings the theme's value back, and each change is one Undo step. Like other Style settings, a value can differ by screen size and state (Normal, Hover, Focus).
Save and check#
- Change one setting and inspect the affected element.
- Use Undo and Redo to check the edit is reversible.
- Save a draft, reopen it, and confirm the content and choices remain.
- Inspect the page at desktop and phone widths.
- Publish only when the result is ready. For interactive elements, check the visitor view because editing mode can suppress interaction.
How it is stored#
The block comes from blocks/360-progress.html. Its editable content is HTML in the page or owning template. Native settings update words, attributes, classes, or supported style properties. Generated interface controls are not saved into that HTML.
The settings registry matches .cb-progress in assets/element-settings.js. Public behavior, when needed, is implemented by the native element runtime in assets/elements.js or assets/blocks.js.