# CMS: Adding and Setting Up a Progress Bar

Source: https://support.wix.com/en/article/cms-adding-and-setting-up-a-progress-bar (updated 2026-11-12)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

Add a progress bar to show a visual representation of progress toward achieving a goal. You can use Velo coding or a CMS collection field to represent the progress value. For the target value, you can set a static value that doesn't change, or set a dynamic value with Velo or by connecting a collection field.

![Screenshot of a progress bar example.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/dfff8cbb-ddcb-4376-8cae-3fedb2dd4458/2019/07/31/21a78e45-8390-4033-808f-6edfb86a28e6/714defe4-64e1-44b1-9826-27b96b4ee179.png)

Examples of using progress bars:

* Show how many tasks are marked as 'done' on a to-do list.
* Show the percentage of steps completed during an onboarding process.
* Show the amount of money raised towards a fundraising goal.
* Show the number of people who have signed a petition that needs a certain number of votes.

> **Note:** In the Wix Harmony Editor, you can connect text, image, and button elements to your collection, and connect galleries to 'Media Gallery' fields. You can't connect other elements, such as progress bars. You can [vote to connect more element types in Wix Harmony](https://support.wix.com/en/article/wix-harmony-editor-feature-request-connecting-additional-element-types-to-your-collection-2).

> **Tip:** You can use Velo to update the progress bar's value without connecting to the CMS. To learn how, see [Working with the progress bar API](https://dev.wix.com/docs/velo/api-reference/$w/progress-bar/introduction).

> **Before you begin:** [Add the CMS](https://support.wix.com/en/article/cms-formerly-content-manager-getting-started) to your site and [create a collection](https://support.wix.com/en/article/cms-formerly-content-manager-creating-a-collection) that includes a 'Number' field type for your progress value. If you want to use a dynamic value for the target value, also add a 'Number' field that represents the target.

### To add and set up a progress bar:

**Wix Editor:**

1. [Go to your editor](https://manage.wix.com/account/site-selector/?actionUrl=https%3A%2F%2Fwww.wix.com%2Feditor%2F%7BmetaSiteId%7D%3FeditorSessionId%3D%7Besi%7D%26).
2. Make sure you have [enabled Velo](https://support.wix.com/en/article/enabling-velo) in your editor:  
   1. Click **Dev Mode** at the top.  
   2. Click **Turn on Dev Mode**.
3. Click **Add Elements** ![](https://d2x3xhvgiqkx42.cloudfront.net/65d5031a-8d20-483c-b08f-0a758e1cf2fd/68a0236f-77f4-43c6-931f-8298ae691a9e/2022/11/17/01f24c8b-2ea3-4d06-a26d-9975a43d617e/a79e245b-4870-4444-ba82-248eca4eb9a7.png) on the left side of the editor.
4. Click **Interactive**.
5. Click **Progress Bar** under **Indicators**.
6. Click and drag the progress bar of your choice onto the page.
7. Click **Settings** on the progress bar.
8. Enter a **Label** that lets visitors and screen readers know what the bar represents (e.g. "Progress toward goal")
9. Choose whether to set the target value as a dynamic value or a static value:

**Dynamic target value**

1. Click the **Connect to CMS** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/06/16/2d484f5d-e1bf-4d48-9e42-82216e8b88de/08e74518-edad-42f8-b007-c974ba767eb6.png) on the progress bar element.
2. Click the **Choose a dataset** drop-down and select an existing dataset that connects to your collection. Alternatively, select **Add a Dataset**, then choose the collection you want to connect, give the dataset a name and click **Create**.
3. Click the **Progress value connects to** drop-down and select the field you want to use to represent progress toward reaching the target goal.
4. Click the **Target value connects to** drop-down and select the field that you want to use to represent the target goal.  
![A screenshot of the Connect Progress Bar panel with the target value connected to a number field.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/05/14/7e13393f-87f9-4f5a-9a74-5500aa0c4515/762be055-5b35-433a-8e2b-8389c679db09.png)
5. Click the **Layout** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/11/06/db711bae-6039-429b-821e-08e3dcd4bd24/e037c257-27f6-4ece-9493-85f24db7a1c6.png) to edit customize the layout of the bar:  
   * **Field title indent:** Drag the slider to change the indentation of the field title, which is the **Label** you enter in the progress bar settings.  
   * **Space between bar and title:** Drag the slider to adjust the distance between the field title and the bar.  
   * **Direction:** Choose the text direction: **Left to right** or **Right to left**  
   * **Alignment:** Choose the text alignment: **Left**, **Center**, or **Right**  
   * **Advanced:** Click **Advanced** to edit the text direction for the label and the direction in which the bar progress moves.
6. Click the **Design** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/11/06/09441655-7021-453d-9255-abde3194f475/2ccaa454-88e1-4b18-861f-2dc0a1953908.png) and choose a preset design or customize the existing design further.

**Static target value**

1. Enter the **Target value** in the field.
2. Click the **Connect to CMS** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/06/16/2d484f5d-e1bf-4d48-9e42-82216e8b88de/08e74518-edad-42f8-b007-c974ba767eb6.png) on the progress bar element.
3. Click the **Choose a dataset** drop-down and select an existing dataset that connects to your collection. Alternatively, select **Add a Dataset**, then choose the collection you want to connect, give the dataset a name and click **Create**.
4. Click the **Progress value connects to** drop-down and select the field you want to use to represent progress toward reaching the target goal.  
![A screenshot of the Connect Progress Bar panel with a static target value and the progress value connected.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2025/05/02/586fed4d-6a26-480a-8486-4b6240fff882/31433830-5cf4-403e-a07d-dedc6a50733e.png)
5. Click the **Layout** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/11/06/db711bae-6039-429b-821e-08e3dcd4bd24/e037c257-27f6-4ece-9493-85f24db7a1c6.png) to edit customize the layout of the bar:  
   * **Field title indent:** Drag the slider to change the indentation of the field title, which is the **Label** you enter in the progress bar settings.  
   * **Space between bar and title:** Drag the slider to adjust the distance between the field title and the bar.  
   * **Direction:** Choose the text direction: **Left to right** or **Right to left**  
   * **Alignment:** Choose the text alignment: **Left**, **Center**, or **Right**  
   * **Advanced:** Click **Advanced** to edit the text direction for the label and the direction in which the bar progress moves.
6. Click the **Design** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/11/06/09441655-7021-453d-9255-abde3194f475/2ccaa454-88e1-4b18-861f-2dc0a1953908.png) and choose a preset design or customize the existing design further.

**Studio Editor:**

1. [Go to your editor](https://manage.wix.com/account/site-selector/?actionUrl=https%3A%2F%2Fwww.wix.com%2Feditor%2F%7BmetaSiteId%7D%3FeditorSessionId%3D%7Besi%7D%26).
2. Click **Add Elements** ![](https://d2x3xhvgiqkx42.cloudfront.net/65d5031a-8d20-483c-b08f-0a758e1cf2fd/68a0236f-77f4-43c6-931f-8298ae691a9e/2022/11/17/01f24c8b-2ea3-4d06-a26d-9975a43d617e/a79e245b-4870-4444-ba82-248eca4eb9a7.png) on the left side of the editor.
3. Click **Input**.
4. Click **Progress Bar** under **Display**.
5. Click and drag the progress bar of your choice onto the page.
6. Click **Settings** on the progress bar.
7. Enter a **Label** that lets visitors and screen readers know what the bar represents (e.g. "Progress toward goal")
8. Choose whether to set the target value as a dynamic value or a static value:

**Dynamic target value**

1. Click the **Connect to CMS** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/06/16/2d484f5d-e1bf-4d48-9e42-82216e8b88de/08e74518-edad-42f8-b007-c974ba767eb6.png) on the progress bar element.
2. Click the **Choose a dataset** drop-down and select an existing dataset that connects to your collection. Alternatively, select **Add a Dataset**, then choose the collection you want to connect, give the dataset a name and click **Create**.
3. Click the **Progress value connects to** drop-down and select the field you want to use to represent progress toward reaching the target goal.
4. Click the **Target value connects to** drop-down and select the field that you want to use to represent the target goal.  
![A screenshot of the Studio Editor Connect Progress Bar panel with the target value connected to a number field.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2025/05/02/60cf685a-6b3d-4ce7-bd71-04e72f326e66/ffbeeb79-1f0e-4e76-b087-7d300f09bd68.png)
5. Click the **Layout** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/11/06/db711bae-6039-429b-821e-08e3dcd4bd24/e037c257-27f6-4ece-9493-85f24db7a1c6.png) to edit customize the layout of the bar:  
   * **Field title indent:** Drag the slider to change the indentation of the field title, which is the **Label** you enter in the progress bar settings.  
   * **Space between bar and title:** Drag the slider to adjust the distance between the field title and the bar.  
   * **Direction:** Choose the text direction: **Left to right** or **Right to left**  
   * **Alignment:** Choose the text alignment: **Left**, **Center**, or **Right**  
   * **Advanced:** Click **Advanced** to edit the text direction for the label and the direction in which the bar progress moves.
6. Click the **Design** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2025/05/02/ba09e92a-e346-424d-b8cc-ec5e29f3394b/1884d4c9-9fed-4736-be32-4446a7001d91.png) in the Inspector panel to edit the design of the progress bar.

**Static target value**

1. Click **Set Target Value** on the progress bar element and enter the value in the **Target value** field.
2. Click the **Connect to CMS** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/06/16/2d484f5d-e1bf-4d48-9e42-82216e8b88de/08e74518-edad-42f8-b007-c974ba767eb6.png) on the progress bar element.
3. Click the **Choose a dataset** drop-down and select an existing dataset that connects to your collection. Alternatively, click **Create Dataset**, then choose the collection you want to connect, give the dataset a name and click **Create**.
4. Click the **Progress value connects to** drop-down and select the field you want to use to represent progress toward reaching the target goal.  
![A screenshot of the Studio Editor Connect Progress Bar panel with a static target value.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/05/14/736cedd2-3761-47ad-a83d-081d1644db94/51ce0c64-0d38-404c-a581-192c9d0195ef.png)
5. Click the **Layout** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/11/06/db711bae-6039-429b-821e-08e3dcd4bd24/e037c257-27f6-4ece-9493-85f24db7a1c6.png) to edit customize the layout of the bar:  
   * **Field title indent:** Drag the slider to change the indentation of the field title, which is the **Label** you enter in the progress bar settings.  
   * **Space between bar and title:** Drag the slider to adjust the distance between the field title and the bar.  
   * **Direction:** Choose the text direction: **Left to right** or **Right to left**  
   * **Alignment:** Choose the text alignment: **Left**, **Center**, or **Right**  
   * **Advanced:** Click **Advanced** to edit the text direction for the label and the direction in which the bar progress moves.
6. Click the **Design** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2025/05/02/ba09e92a-e346-424d-b8cc-ec5e29f3394b/1884d4c9-9fed-4736-be32-4446a7001d91.png) in the Inspector panel to edit the design of the progress bar.
