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")
forum

Still have questions?

Our forums are full of helpful information and Streamlit experts.