st.text

We value your privacy.

st.latex

Welcome to Streamlit

Untitled

How do I add a Component to the sidebar?

My Component seems to be blinking/stuttering...how do I fix that?

How do Streamlit Components differ from functionality provided in the base Streamlit package?

Streamlit Components

What types of things aren't possible with Streamlit Components?

Installing Dependencies

ImportError libGL.so.1 cannot open shared object file No such file or directory

ModuleNotFoundError No module named

ERROR No matching distribution found for

How can I deploy multiple Streamlit apps on different subdomains?

How do I deploy Streamlit on a domain so it appears to run on a regular port (i.e. port 80)?

How do I deploy Streamlit on Heroku, AWS, Google Cloud, etc...?

Does Streamlit support the WSGI Protocol? (aka Can I deploy Streamlit with gunicorn?)

Deployment Issues

App is not loading when running remotely

Argh. This app has gone over its resource limits

Error Messages

Knowledge Base

Connect Streamlit to AWS S3

Connect Streamlit to Google BigQuery

Connect to data sources

Connect Streamlit to MySQL

Connect Streamlit to PostgreSQL

Connect Streamlit to a private Google Sheet

Connect Streamlit to a public Google Sheet

Connect Streamlit to Tableau

Connect Streamlit to TigerGraph

Tutorials

Visualising rent prices with Streamlit

How to animate elements?

Append data to a table or chart

Batch elements and input widgets with st.form

Caching issues

How to download a file in Streamlit?

How to download a Pandas DataFrame as a CSV?

Using Streamlit

How to insert elements out of order?

What is the path of Streamlit’s config.toml file?

How can I make st.pydeck_chart use custom Mapbox styles?

How to record a screencast?

How to remove "· Streamlit" from the app title?

How do you retrieve the filename of a file uploaded with st.file_uploader?

Sanity checks

How can I make Streamlit watch for changes in other modules I'm importing in my app?

What browsers does Streamlit support?

Where does st.file_uploader store uploaded files and when do they get deleted?

Advanced Features

Widget semantics

Optimize performance with st.cache

Configuration

Pre-release features

Add statefulness to apps

Theming

API Reference

st.altair_chart

st.area_chart

st.bar_chart

st.bokeh_chart

st.code

Table to concat. Optional.
Pyarrow tables are not supported by Streamlit's legacy DataFrame serialization
(i.e. with <cite>config.dataFrameSerialization = &quot;legacy&quot;</cite>).
To use pyarrow tables, please enable pyarrow by changing the config setting,
<cite>config.dataFrameSerialization = &quot;arrow&quot;</cite>.

data

The named dataset to concat. Optional. You can only pass in 1
dataset (including the one in the data parameter).

**kwargs

Concatenate a dataframe to the bottom of the current one.

add_rows

The Altair chart object to display.

altair_chart

If True, set the chart width to the column width. This takes
precedence over Altair's native <cite>width</cite> value.

use_container_width

Display a chart using the Altair library.

Data to be plotted.
Pyarrow tables are not supported by Streamlit's legacy DataFrame serialization
(i.e. with <cite>config.dataFrameSerialization = &quot;legacy&quot;</cite>).
To use pyarrow tables, please enable pyarrow by changing the config setting,
<cite>config.dataFrameSerialization = &quot;arrow&quot;</cite>.

The chart width in pixels. If 0, selects the width automatically.

width

The chart height in pixels. If 0, selects the height automatically.

height

If True, set the chart width to the column width. This takes
precedence over the width argument.

area_chart

io.open().
Raw audio data, filename, or a URL pointing to the file to load.
Numpy arrays and raw data formats must include all necessary file
headers to match specified file format.

The time from which this element should start playing.

start_time

The mime type for the audio file. Defaults to 'audio/wav'.
See <a class="reference external" href="https://tools.ietf.org/html/rfc4281">https://tools.ietf.org/html/rfc4281</a> for more info.

format

audio

balloons

bar_chart

<dl class="docutils">
<dt>If an int</dt>
<dd>Specifies the number of columns to insert, and all columns
have equal width.</dd>
<dt>If a list of numbers</dt>
<dd>Creates a column for each number, and each
column's width is proportional to the number provided. Numbers can
be ints or floats, but they must be positive.
For example, <cite>st.columns([3, 1, 2])</cite> creates 3 columns where
the first column is 3 times the width of the second, and the last
column is 2 times that width.
</dd>
</dl>

spec

Insert containers laid out as side-by-side columns.

beta_columns

beta_container

A string to use as the header for the expander.

label

If True, initializes the expander in &quot;expanded&quot; state. Defaults to
False (collapsed).

expanded

Insert a multi-element container that can be expanded/collapsed.

beta_expander

figure

If True, set the chart width to the column width. This takes
precedence over Bokeh's native <cite>width</cite> value.

To show Bokeh charts in Streamlit, call `st.bokeh_chart`

wherever you would call Bokeh's `show`.

bokeh_chart

A short label explaining to the user what this button is for.

An optional string or integer to use as the unique key for the widget.
If this is omitted, a key will be generated for the widget
based on its content. Multiple widgets of the same type may
not share the same key.

An optional tooltip that gets displayed when the button is
hovered over.

help

An optional callback invoked when this button is clicked.

on_click

An optional tuple of args to pass to the callback.

args

An optional dict of kwargs to pass to the callback.

kwargs

button

body

caption

A short label explaining to the user what this checkbox is for.

Preselect the checkbox when it first renders. This will be
cast to bool internally.

value

An optional tooltip that gets displayed next to the checkbox.

An optional callback invoked when this checkbox's value changes.

on_change

checkbox

The language that the code is written in, for syntax highlighting.
If omitted, the code will be unstyled.

language

Display a code block with optional syntax highlighting.

code

A short label explaining to the user what this input is for.

The hex value of this widget when it first renders. If None,
defaults to black.

An optional tooltip that gets displayed next to the color picker.

An optional callback invoked when this color_picker's value
changes.

color_picker

columns

container

The data to display.
If 'data' is a pandas.Styler, it will be used to style its
underyling DataFrame. Streamlit supports custom cell
values and colors. (It does not support some of the more exotic
pandas styling features, like bar charts, hovering, and captions.)
Styler support is experimental!
Pyarrow tables are not supported by Streamlit's legacy DataFrame serialization
(i.e. with <cite>config.dataFrameSerialization = &quot;legacy&quot;</cite>).
To use pyarrow tables, please enable pyarrow by changing the config setting,
<cite>config.dataFrameSerialization = &quot;arrow&quot;</cite>.

Desired width of the UI element expressed in pixels. If None, a
default width based on the page width is used.

Desired height of the UI element expressed in pixels. If None, a
default height is used.

Display a dataframe as an interactive table.

dataframe

A short label explaining to the user what this date input is for.

The value of this widget when it first renders. If a list/tuple with
0 to 2 date/datetime values is provided, the datepicker will allow
users to provide a range. Defaults to today as a single-date picker.

The minimum selectable date. If value is a date, defaults to value - 10 years.
If value is the interval [start, end], defaults to start - 10 years.

min_value

The maximum selectable date. If value is a date, defaults to value + 10 years.
If value is the interval [start, end], defaults to end + 10 years.

max_value

An optional tooltip that gets displayed next to the input.

An optional callback invoked when this date_input's value changes.

date_input

determine_delta_color_and_direction

The contents of the file to be downloaded. See example below for
caching techniques to avoid recomputing this data unnecessarily.

An optional string to use as the name of the file to be downloaded,
such as 'my_file.csv'. If not specified, the name will be
automatically generated.

file_name

The MIME type of the data. If None, defaults to &quot;text/plain&quot;
(if data is of type str or is a textual file) or
&quot;application/octet-stream&quot; (if data is of type bytes or is a
binary file).

mime

download_button

empty

error

exception

expander

A short label explaining to the user what this file uploader is for.

Array of allowed extensions. ['png', 'jpg']
The default is None, which means all extensions are allowed.

type

If True, allows the user to upload multiple files at the same time,
in which case the return value will be a list of files.
Default: False

accept_multiple_files

A tooltip that gets displayed next to the file uploader.

An optional callback invoked when this file_uploader's value
changes.

file_uploader

A string that identifies the form. Each form must have its own
key. (This key is not displayed to the user in the interface.)

If True, all widgets inside the form will be reset to their default
values after the user presses the Submit button. Defaults to False.
(Note that Custom Components are unaffected by this flag, and
will not be reset to their defaults on form submission.)

clear_on_submit

Create a form that batches elements together with a "Submit" button.

form

A short label explaining to the user what this button is for.
Defaults to &quot;Submit&quot;.

A tooltip that gets displayed when the button is hovered over.
Defaults to None.

form_submit_button

The Graphlib graph object or dot string to display

figure_or_dot

If True, set the chart width to the column width. This takes
precedence over the figure's native <cite>width</cite> value.

Display a graph using the dagre-d3 library.

graphviz_chart

The anchor name of the header that can be accessed with #anchor
in the URL. If omitted, it generates an anchor using the body.

anchor

header

The object whose docstring should be displayed.

Display object's doc string, nicely formatted.

Monochrome image of shape (w,h) or (w,h,1)
OR a color image of shape (w,h,3)
OR an RGBA image of shape (w,h,4)
OR a URL to fetch the image from
OR a path of a local image file
OR an SVG XML string like <cite>&lt;svg xmlns=...&lt;/svg&gt;</cite>
OR a list of one of the above, to display multiple images.

image

Image caption. If displaying multiple images, caption should be a
list of captions (one for each image).

Image width. None means use the image width,
but do not exceed the width of the column.
Should be set for SVG images, as they have no default image width.

If 'auto', set the image's width to its natural size,
but do not exceed the width of the column.
If 'always' or True, set the image's width to the column width.
If 'never' or False, set the image's width to its natural size.
Note: if set, <cite>use_column_width</cite> takes precedence over the <cite>width</cite> parameter.

use_column_width

Clamp image pixel values to a valid range ([0-255] per channel).
This is only meaningful for byte array images; the parameter is
ignored for image URLs. If this is not set, and an image has an
out-of-range value, an error will be thrown.

clamp

If image is an nd.array, this parameter denotes the format used to
represent color information. Defaults to 'RGB', meaning
<cite>image[:, :, 0]</cite> is the red channel, <cite>image[:, :, 1]</cite> is green, and
<cite>image[:, :, 2]</cite> is blue. For images coming from libraries like
OpenCV you should set this to 'BGR', instead.

channels

This parameter specifies the format to use when transferring the
image data. Photos should use the JPEG format for lossy compression
while diagrams should use the PNG format for lossless compression.
Defaults to 'auto' which identifies the compression type based
on the type and format of the image argument.

Function signature
st.text(body)
Parameters
body (str)	The string to display.

st.text

Example

Still have questions?