Insert a single-element container.
Inserts a container into your app that can be used to hold a single element. This allows you to, for example, remove elements at any point, or replace several elements at once (using a child multi-element container).
To insert/replace/clear an element on the returned container, you can use with notation or just call methods directly on the returned object. See examples below.
| Function signature[source] | |
|---|---|
st.empty() |
Examples
Inside a with st.empty(): block, each displayed element will replace the previous one.
import streamlit as st import time with st.empty(): for seconds in range(10): st.write(f"⏳ {seconds} seconds have passed") time.sleep(1) st.write(":material/check: 10 seconds over!") st.button("Rerun")You can use an st.empty to replace multiple elements in succession. Use st.container inside st.empty to display (and later replace) a group of elements.
import streamlit as st import time st.button("Start over") placeholder = st.empty() placeholder.markdown("Hello") time.sleep(1) placeholder.progress(0, "Wait for it...") time.sleep(1) placeholder.progress(50, "Wait for it...") time.sleep(1) placeholder.progress(100, "Wait for it...") time.sleep(1) with placeholder.container(): st.line_chart({"data": [1, 5, 2, 6]}) time.sleep(1) st.markdown("3...") time.sleep(1) st.markdown("2...") time.sleep(1) st.markdown("1...") time.sleep(1) placeholder.markdown("Poof!") time.sleep(1) placeholder.empty()
Still have questions?
Our forums are full of helpful information and Streamlit experts.