st.progress

Show API reference for

Display a progress bar.

Function signature[source]
st.progress(value, text=None, width="stretch")
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. Common block-level Markdown (headings, lists, blockquotes) is automatically escaped and displays as literal text in labels. See the `body` parameter of `st.markdown` for additional, supported Markdown directives.
width ("stretch" or int)	The width of the progress element. This can be one of the following: `"stretch"` (default): The width of the element matches the width of the parent container. An integer specifying the width in pixels: The element has a fixed width. If the specified width is greater than the width of the parent container, the width of the element matches the width of the parent container.

Examples

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

star

Tip

Want a new st.progress feature or found a bug? Browse open issues and react with a 👍 on the initial post of the ones that matter to you. Your votes help us prioritize what to work on next.

arrow_backPrevious: st.exception arrow_forwardNext: st.spinner

forum

Still have questions?

Our forums are full of helpful information and Streamlit experts.