Input widgets

With widgets, Streamlit allows you to bake interactivity directly into your apps with buttons, sliders, text inputs, and more.

Button elements

Button

Display a button widget.

Python

clicked = st.button("Click me")

Download button

Display a download button widget.

Python

st.download_button("Download file", file)

Form button

Display a form submit button. For use with st.form.

Python

st.form_submit_button("Sign up")

Link button

Display a link button.

Python

st.link_button("Go to gallery", url)

Page link

Display a link to another page in a multipage app.

Python

st.page_link("app.py", label="Home", icon="🏠")
st.page_link("pages/profile.py", label="My profile")

Selection elements

Checkbox

Display a checkbox widget.

Python

selected = st.checkbox("I agree")

Color picker

Display a color picker widget.

Python

color = st.color_picker("Pick a color")

Feedback

Display a rating or sentiment button group.

Python

st.feedback("stars")

Multiselect

Display a multiselect widget. The multiselect widget starts as empty.

Python

choices = st.multiselect("Buy", ["milk", "apples", "potatoes"])

Pills

Display a pill-button selection widget.

Python

st.pills("Tags", ["Sports", "AI", "Politics"])

Radio

Display a radio button widget.

Python

choice = st.radio("Pick one", ["cats", "dogs"])

Segmented control

Display a segmented-button selection widget.

Python

st.segmented_control("Filter", ["Open", "Closed", "All"])

Select slider

Display a slider widget to select items from a list.

Python

size = st.select_slider("Pick a size", ["S", "M", "L"])

Selectbox

Display a select widget.

Python

choice = st.selectbox("Pick one", ["cats", "dogs"])

Toggle

Display a toggle widget.

Python

activated = st.toggle("Activate")

Numeric input elements

Number input

Display a numeric input widget.

Python

choice = st.number_input("Pick a number", 0, 10)

Slider

Display a slider widget.

Python

number = st.slider("Pick a number", 0, 100)

Date and time input elements

Date input

Display a date input widget.

Python

date = st.date_input("Your birthday")

Datetime input

Display a datetime input widget.

Python

datetime = st.datetime_input("Schedule your event")

Time input

Display a time input widget.

Python

time = st.time_input("Meeting time")

Text input elements

Text input

Display a single-line text input widget.

Python

name = st.text_input("First name")

Text area

Display a multi-line text input widget.

Python

text = st.text_area("Text to translate")

Chat input

Display a chat input widget.

Python

prompt = st.chat_input("Say something")
if prompt:
    st.write(f"The user has sent: {prompt}")

Other input elements

Audio input

Display a widget that allows users to record with their microphone.

Python

speech = st.audio_input("Record a voice message")

Data editor

Display a data editor widget.

Python

edited = st.data_editor(df, num_rows="dynamic")

File uploader

Display a file uploader widget.

Python

data = st.file_uploader("Upload a CSV")

Camera input

Display a widget that allows users to upload images directly from a camera.

Python

image = st.camera_input("Take a picture")

Third-party components

Streamlit Chat

Streamlit Component for a Chatbot UI. Created by @AI-Yash.

Python

from streamlit_chat import message

message("My message")
message("Hello bot!", is_user=True)  # align's the message to the right

Streamlit Option Menu

Select a single item from a list of options in a menu. Created by @victoryhb.

Python

from streamlit_option_menu import option_menu

option_menu("Main Menu", ["Home", 'Settings'],
  icons=['house', 'gear'], menu_icon="cast", default_index=1)

Streamlit Extras

A library with useful Streamlit extras. Created by @arnaudmiribel.

Python

from streamlit_extras.stoggle import stoggle

stoggle(
    "Click me!", """🥷 Surprise! Here's some additional content""",)

Streamlit Elements

Create a draggable and resizable dashboard in Streamlit. Created by @okls.

Python

from streamlit_elements import elements, mui, html

with elements("new_element"):
  mui.Typography("Hello world")

Stqdm

The simplest way to handle a progress bar in streamlit app. Created by @Wirg.

Python

from stqdm import stqdm

for _ in stqdm(range(50)):
    sleep(0.5)

Timeline

Display a Timeline in Streamlit apps using TimelineJS. Created by @innerdoc.

Python

from streamlit_timeline import timeline

with open('example.json', "r") as f:
  timeline(f.read(), height=800)

Camera input live

Alternative for st.camera_input which returns the webcam images live. Created by @blackary.

Python

from camera_input_live import camera_input_live

image = camera_input_live()
st.image(value)

Streamlit Chat

Streamlit Component for a Chatbot UI. Created by @AI-Yash.

Python

from streamlit_chat import message

message("My message")
message("Hello bot!", is_user=True)  # align's the message to the right

Streamlit Option Menu

Select a single item from a list of options in a menu. Created by @victoryhb.

Python

from streamlit_option_menu import option_menu

option_menu("Main Menu", ["Home", 'Settings'],
  icons=['house', 'gear'], menu_icon="cast", default_index=1)

Streamlit Extras

A library with useful Streamlit extras. Created by @arnaudmiribel.

Python

from streamlit_extras.stoggle import stoggle

stoggle(
    "Click me!", """🥷 Surprise! Here's some additional content""",)

Streamlit Elements

Create a draggable and resizable dashboard in Streamlit. Created by @okls.

Python

from streamlit_elements import elements, mui, html

with elements("new_element"):
  mui.Typography("Hello world")

Timeline

Display a Timeline in Streamlit apps using TimelineJS. Created by @innerdoc.

Python

from streamlit_timeline import timeline

with open('example.json', "r") as f:
  timeline(f.read(), height=800)

Camera input live

Alternative for st.camera_input which returns the webcam images live. Created by @blackary.

Python

from camera_input_live import camera_input_live

image = camera_input_live()
st.image(value)

Streamlit Chat

Streamlit Component for a Chatbot UI. Created by @AI-Yash.

Python

from streamlit_chat import message

message("My message")
message("Hello bot!", is_user=True)  # align's the message to the right

Streamlit Option Menu

Select a single item from a list of options in a menu. Created by @victoryhb.

Python

from streamlit_option_menu import option_menu

option_menu("Main Menu", ["Home", 'Settings'],
  icons=['house', 'gear'], menu_icon="cast", default_index=1)

Streamlit Extras

A library with useful Streamlit extras. Created by @arnaudmiribel.

Python

from streamlit_extras.stoggle import stoggle

stoggle(
    "Click me!", """🥷 Surprise! Here's some additional content""",)

arrow_backPrevious: Chart elements arrow_forwardNext: st.button

forum

Still have questions?

Our forums are full of helpful information and Streamlit experts.