---
title: "Progress Bar Custom Widget"
slug: "progress-bar-custom-widget"
updated: 2026-04-23T13:46:06Z
published: 2026-04-23T13:46:06Z
canonical: "support.tulip.co/progress-bar-custom-widget"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.tulip.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Progress Bar Custom Widget

To download, visit: [Library](https://library.tulip.co/apps/progress-bar-widget).

*Visualize the percent completion of two values using the progress bar custom widget*

## Purpose

This custom widget includes a progress bar that shows the ratio between two variables. It is animated dynamically as any change to the percentage is made. It can be great for use as a loading bar, or to show the percentage of current to total.

## Setup

For setup, the following parameters need to be configured:

- **Current Value:** Integer variable to be divided by the total value
- **Total Value:** Integer variable that holds the total value

## How it works

This custom widget expands its green boundaries based on the ratio of the current value and the total value. At 0% the bar is blank, and at 100% the bar is completely filled.

## Further Reading

If you would like to know more about custom widgets please visit the site below:

- [*Custom Widgets Overview*](https://support.tulip.co/docs/custom-widgets-overview)