Hello there 👋

Thanks for stopping by! We use cookies to help us understand how you interact with our website.

By clicking “Accept all”, you consent to our use of cookies. For more information, please see our privacy policy.

st.progress

Display a progress bar.

Function signature[source]
st.progress(value, text=None)
Parameters
value (int or float)	0 <= value <= 100 for int 0.0 <= value <= 1.0 for float
text (str or None)	A message to display above the progress bar. The text can optionally contain GitHub-flavored Markdown of the following types: Bold, Italics, Strikethroughs, Inline Code, Links, and Images. Images display like icons, with a max height equal to the font height. Unsupported Markdown elements are unwrapped so only their children (text contents) render. Display unsupported elements as literal characters by backslash-escaping them. E.g., `"1\. Not an ordered list"`. See the `body` parameter of `st.markdown` for additional, supported Markdown directives.

Example

Here is an example of a progress bar increasing over time and disappearing when it reaches completion:

import streamlit as st
import time

progress_text = "Operation in progress. Please wait."
my_bar = st.progress(0, text=progress_text)

for percent_complete in range(100):
    time.sleep(0.01)
    my_bar.progress(percent_complete + 1, text=progress_text)
time.sleep(1)
my_bar.empty()

st.button("Rerun")

Built with Streamlit 🎈

Fullscreen open_in_new

Previous: st.exception Next: st.spinner

forum

Still have questions?

Our forums are full of helpful information and Streamlit experts.