st.error

We value your privacy.

st.warning

st.snow

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

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

The theme of the chart. Currently, we only support &quot;streamlit&quot; for the Streamlit
defined design or None to fallback to the default behavior of the library.

theme

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 <tt class="docutils literal">config.dataFrameSerialization = &quot;legacy&quot;</tt>).
To use pyarrow tables, please enable pyarrow by changing the config setting,
<tt class="docutils literal">config.dataFrameSerialization = &quot;arrow&quot;</tt>.

Column name to use for the x-axis. If None, uses the data index for the x-axis.
This argument can only be supplied by keyword.

Column name(s) to use for the y-axis. If a sequence of strings, draws several series
on the same chart by melting your wide-format table into a long-format table behind
the scenes. If None, draws the data of all remaining columns as data series.
This argument can only be supplied by keyword.

The color to use for different series in this chart. This argument
can only be supplied by keyword.
For an area chart with just 1 series, this can be:
<ul class="simple">
<li>None, to use the default color.</li>
<li>A hex string like &quot;#ffaa00&quot; or &quot;#ffaa0088&quot;.</li>
<li>An RGB or RGBA tuple with the red, green, blue, and alpha
components specified as ints from 0 to 255 or floats from 0.0 to
1.0.</li>
</ul>
For an area chart with multiple series, where the dataframe is in
long format (that is, y is None or just one column), this can be:
<ul>
<li>None, to use the default colors.
</li>
<li>The name of a column in the dataset. Data points will be grouped
into series of the same color based on the value of this column.
In addition, if the values in this column match one of the color
formats above (hex string or color tuple), then that color will
be used.
For example: if the dataset has 1000 rows, but this column can
only contains the values &quot;adult&quot;, &quot;child&quot;, &quot;baby&quot;,
then those 1000 datapoints will be grouped into 3 series, whose
colors will be automatically selected from the default palette.
But, if for the same 1000-row dataset, this column contained
the values &quot;#ffaa00&quot;, &quot;#f0f&quot;, &quot;#0000ff&quot;, then then those 1000
datapoints would still be grouped into 3 series, but their
colors would be &quot;#ffaa00&quot;, &quot;#f0f&quot;, &quot;#0000ff&quot; this time around.
</li>
</ul>
For an area chart with multiple series, where the dataframe is in
wide format (that is, y is a sequence of columns), this can be:
<ul class="simple">
<li>None, to use the default colors.</li>
<li>A list of string colors or color tuples to be used for each of
the series in the chart. This list should have the same length
as the number of y values (e.g. <tt class="docutils literal">color=[&quot;#fd0&quot;, &quot;#f0f&quot;, &quot;#04f&quot;]</tt>
for three lines).</li>
</ul>

color

The chart width in pixels. If 0, selects the width automatically.
This argument can only be supplied by keyword.

width

The chart height in pixels. If 0, selects the height automatically.
This argument can only be supplied by keyword.

height

If True, set the chart width to the column width. This takes
precedence over the width argument.
This argument can only be supplied by keyword.

Display an area chart.
This is just syntax-sugar around st.altair_chart. The main difference
is this command uses the data's own column and indices to figure out
the chart's spec. As a result this is easier to use for many &quot;just plot
this&quot; scenarios, while being less customizable.
If st.area_chart does not guess the data specification
correctly, try specifying your desired chart using st.altair_chart.

area_chart

Raw audio data, filename, or a URL pointing to the file to load.
Raw data formats must include all necessary file headers to match the file
format specified via <tt class="docutils literal">format</tt>.
If <tt class="docutils literal">data</tt> is a numpy array, it must either be a 1D array of the waveform
or a 2D array of shape <tt class="docutils literal">(num_channels, num_samples)</tt> with waveforms
for all channels. See the default channel order at
<a class="reference external" href="http://msdn.microsoft.com/en-us/library/windows/hardware/dn653308(v=vs.85).aspx">http://msdn.microsoft.com/en-us/library/windows/hardware/dn653308(v=vs.85).aspx</a>

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

The time from which this element should start playing.

start_time

The sample rate of the audio data in samples per second. Only required if
<tt class="docutils literal">data</tt> is a numpy array.

sample_rate

audio

balloons

The color to use for different series in this chart. This argument
can only be supplied by keyword.
For a bar chart with just 1 series, this can be:
<ul class="simple">
<li>None, to use the default color.</li>
<li>A hex string like &quot;#ffaa00&quot; or &quot;#ffaa0088&quot;.</li>
<li>An RGB or RGBA tuple with the red, green, blue, and alpha
components specified as ints from 0 to 255 or floats from 0.0 to
1.0.</li>
</ul>
For a bar chart with multiple series, where the dataframe is in
long format (that is, y is None or just one column), this can be:
<ul>
<li>None, to use the default colors.
</li>
<li>The name of a column in the dataset. Data points will be grouped
into series of the same color based on the value of this column.
In addition, if the values in this column match one of the color
formats above (hex string or color tuple), then that color will
be used.
For example: if the dataset has 1000 rows, but this column can
only contains the values &quot;adult&quot;, &quot;child&quot;, &quot;baby&quot;,
then those 1000 datapoints will be grouped into 3 series, whose
colors will be automatically selected from the default palette.
But, if for the same 1000-row dataset, this column contained
the values &quot;#ffaa00&quot;, &quot;#f0f&quot;, &quot;#0000ff&quot;, then then those 1000
datapoints would still be grouped into 3 series, but their
colors would be &quot;#ffaa00&quot;, &quot;#f0f&quot;, &quot;#0000ff&quot; this time around.
</li>
</ul>
For a bar chart with multiple series, where the dataframe is in
wide format (that is, y is a sequence of columns), this can be:
<ul class="simple">
<li>None, to use the default colors.</li>
<li>A list of string colors or color tuples to be used for each of
the series in the chart. This list should have the same length
as the number of y values (e.g. <tt class="docutils literal">color=[&quot;#fd0&quot;, &quot;#f0f&quot;, &quot;#04f&quot;]</tt>
for three lines).</li>
</ul>

Display a bar chart.
This is just syntax-sugar around st.altair_chart. The main difference
is this command uses the data's own column and indices to figure out
the chart's spec. As a result this is easier to use for many &quot;just plot
this&quot; scenarios, while being less customizable.
If st.bar_chart does not guess the data specification
correctly, try specifying your desired chart using st.altair_chart.

bar_chart

figure

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

Display an interactive Bokeh chart.
Bokeh is a charting library for Python. The arguments to this function
closely follow the ones for Bokeh's <cite>show</cite> function. You can find
more about Bokeh at <a class="reference external" href="https://bokeh.pydata.org">https://bokeh.pydata.org</a>.
To show Bokeh charts in Streamlit, call <cite>st.bokeh_chart</cite>
wherever you would call Bokeh's <cite>show</cite>.

bokeh_chart

A short label explaining to the user what this button is for.
The label can optionally contain Markdown and supports the following
elements: Bold, Italics, Strikethroughs, Inline Code, and Emojis.
This also supports:
<ul class="simple">
<li>Emoji shortcodes, such as <tt class="docutils literal">:+1:</tt> and <tt class="docutils literal">:sunglasses:</tt>.
For a list of all supported codes,
see <a class="reference external" href="https://share.streamlit.io/streamlit/emoji-shortcodes">https://share.streamlit.io/streamlit/emoji-shortcodes</a>.</li>
<li>LaTeX expressions, by wrapping them in &quot;$&quot; or &quot;$$&quot; (the &quot;$$&quot;
must be on their own lines). Supported LaTeX functions are listed
at <a class="reference external" href="https://katex.org/docs/supported.html">https://katex.org/docs/supported.html</a>.</li>
<li>Colored text, using the syntax <tt class="docutils literal">:color[text to be colored]</tt>,
where <tt class="docutils literal">color</tt> needs to be replaced with any of the following
supported colors: blue, green, orange, red, violet, gray/grey, rainbow.</li>
</ul>
Unsupported elements are unwrapped so only their children (text contents) render.
Display unsupported elements as literal characters by
backslash-escaping them. E.g. <tt class="docutils literal">1\. Not an ordered list</tt>.

label

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

An optional string that specifies the button type. Can be &quot;primary&quot; for a
button with additional emphasis or &quot;secondary&quot; for a normal button. This
argument can only be supplied by keyword. Defaults to &quot;secondary&quot;.

type

An optional boolean, which disables the button if set to True. The
default is False. This argument can only be supplied by keyword.

disabled

An optional boolean, which makes the button stretch its width to match the parent container.

button

True if the button was clicked on the last run of the app,
False otherwise.

A short label explaining to the user what this widget is used for.
The label can optionally contain Markdown and supports the following
elements: Bold, Italics, Strikethroughs, Inline Code, Emojis, and Links.
This also supports:
<ul class="simple">
<li>Emoji shortcodes, such as <tt class="docutils literal">:+1:</tt> and <tt class="docutils literal">:sunglasses:</tt>.
For a list of all supported codes,
see <a class="reference external" href="https://share.streamlit.io/streamlit/emoji-shortcodes">https://share.streamlit.io/streamlit/emoji-shortcodes</a>.</li>
<li>LaTeX expressions, by wrapping them in &quot;$&quot; or &quot;$$&quot; (the &quot;$$&quot;
must be on their own lines). Supported LaTeX functions are listed
at <a class="reference external" href="https://katex.org/docs/supported.html">https://katex.org/docs/supported.html</a>.</li>
<li>Colored text, using the syntax <tt class="docutils literal">:color[text to be colored]</tt>,
where <tt class="docutils literal">color</tt> needs to be replaced with any of the following
supported colors: blue, green, orange, red, violet, gray/grey, rainbow.</li>
</ul>
Unsupported elements are unwrapped so only their children (text contents) render.
Display unsupported elements as literal characters by
backslash-escaping them. E.g. <tt class="docutils literal">1\. Not an ordered list</tt>.
For accessibility reasons, you should never set an empty label (label=&quot;&quot;)
but hide it with label_visibility if needed. In the future, we may disallow
empty labels by raising an exception.

A tooltip that gets displayed next to the camera input.

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

on_change

An optional boolean, which disables the camera input if set to
True. The default is False. This argument can only be supplied by
keyword.

The visibility of the label. If &quot;hidden&quot;, the label doesn't show but there
is still empty space for it above the widget (equivalent to label=&quot;&quot;).
If &quot;collapsed&quot;, both the label and the space are removed. Default is
&quot;visible&quot;. This argument can only be supplied by keyword.

label_visibility

Display a widget that returns pictures from the user's webcam.

camera_input

The UploadedFile class is a subclass of BytesIO, and therefore
it is &quot;file-like&quot;. This means you can pass them anywhere where
a file is expected.

The text to display as Github-flavored Markdown. Syntax
information can be found at: <a class="reference external" href="https://github.github.com/gfm">https://github.github.com/gfm</a>.
This also supports:
<ul class="simple">
<li>Emoji shortcodes, such as <tt class="docutils literal">:+1:</tt> and <tt class="docutils literal">:sunglasses:</tt>.
For a list of all supported codes,
see <a class="reference external" href="https://share.streamlit.io/streamlit/emoji-shortcodes">https://share.streamlit.io/streamlit/emoji-shortcodes</a>.</li>
<li>LaTeX expressions, by wrapping them in &quot;$&quot; or &quot;$$&quot; (the &quot;$$&quot;
must be on their own lines). Supported LaTeX functions are listed
at <a class="reference external" href="https://katex.org/docs/supported.html">https://katex.org/docs/supported.html</a>.</li>
<li>Colored text, using the syntax <tt class="docutils literal">:color[text to be colored]</tt>,
where <tt class="docutils literal">color</tt> needs to be replaced with any of the following
supported colors: blue, green, orange, red, violet, gray/grey, rainbow.</li>
</ul>

body

By default, any HTML tags found in strings will be escaped and
therefore treated as pure text. This behavior may be turned off by
setting this argument to True.
That said, we strongly advise against it. It is hard to write secure
HTML, so by using this argument you may be compromising your users'
security. For more information, see:
<a class="reference external" href="https://github.com/streamlit/streamlit/issues/152">https://github.com/streamlit/streamlit/issues/152</a>

unsafe_allow_html

An optional tooltip that gets displayed next to the caption.

Display text in small font.
This should be used for captions, asides, footnotes, sidenotes, and
other explanatory text.

caption

A placeholder text shown when the chat input is empty. Defaults to
&quot;Your message&quot;. For accessibility reasons, you should not use an
empty string.

placeholder

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.

The maximum number of characters that can be entered. If None
(default), there will be no maximum.

max_chars

Whether the chat input should be disabled. Defaults to False.

An optional callback invoked when the chat input's value is submitted.

on_submit

Display a chat input widget.
<div class="admonition warning">
Warning
Chat input can only be used once per app page and inside the main area of the app.
It cannot be used in the sidebar, columns, expanders, forms or tabs.
We plan to support this in the future.
</div>

chat_input

The current (non-empty) value of the text input widget on the last
run of the app, None otherwise.

The name of the message author. Can be &quot;human&quot;/&quot;user&quot; or
&quot;ai&quot;/&quot;assistant&quot; to enable preset styling and avatars.
Currently, the name is not shown in the UI but is only set as an
accessibility label. For accessibility reasons, you should not use
an empty string.

name

The avatar shown next to the message. Can be one of:
<ul class="simple">
<li>A single emoji, e.g. &quot;🧑‍💻&quot;, &quot;🤖&quot;, &quot;🦖&quot;. Shortcodes are not supported.</li>
<li><dl class="first docutils">
<dt>An image using one of the formats allowed for <tt class="docutils literal">st.image</tt>: path of a local</dt>
<dd>image file; URL to fetch the image from; array of shape (w,h) or (w,h,1)
for a monochrome image, (w,h,3) for a color image, or (w,h,4) for an RGBA image.</dd>
</dl>
</li>
</ul>
If None (default), uses default icons if <tt class="docutils literal">name</tt> is &quot;user&quot;,
&quot;assistant&quot;, &quot;ai&quot;, &quot;human&quot; or the first letter of the <tt class="docutils literal">name</tt> value.

avatar

Insert a chat message container.
To add elements to the returned container, you can use <tt class="docutils literal">with</tt> notation
(preferred) or just call methods directly on the returned object. See the
examples below.

chat_message

A single container that can hold multiple elements.

A short label explaining to the user what this checkbox is for.
The label can optionally contain Markdown and supports the following
elements: Bold, Italics, Strikethroughs, Inline Code, Emojis, and Links.
This also supports:
<ul class="simple">
<li>Emoji shortcodes, such as <tt class="docutils literal">:+1:</tt> and <tt class="docutils literal">:sunglasses:</tt>.
For a list of all supported codes,
see <a class="reference external" href="https://share.streamlit.io/streamlit/emoji-shortcodes">https://share.streamlit.io/streamlit/emoji-shortcodes</a>.</li>
<li>LaTeX expressions, by wrapping them in &quot;$&quot; or &quot;$$&quot; (the &quot;$$&quot;
must be on their own lines). Supported LaTeX functions are listed
at <a class="reference external" href="https://katex.org/docs/supported.html">https://katex.org/docs/supported.html</a>.</li>
<li>Colored text, using the syntax <tt class="docutils literal">:color[text to be colored]</tt>,
where <tt class="docutils literal">color</tt> needs to be replaced with any of the following
supported colors: blue, green, orange, red, violet, gray/grey, rainbow.</li>
</ul>
Unsupported elements are unwrapped so only their children (text contents) render.
Display unsupported elements as literal characters by
backslash-escaping them. E.g. <tt class="docutils literal">1\. Not an ordered list</tt>.
For accessibility reasons, you should never set an empty label (label=&quot;&quot;)
but hide it with label_visibility if needed. In the future, we may disallow
empty labels by raising an exception.

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.

An optional boolean, which disables the checkbox if set to True.
The default is False. This argument can only be supplied by keyword.

The visibility of the label. If &quot;hidden&quot;, the label doesn't show but there
is still empty space for it (equivalent to label=&quot;&quot;).
If &quot;collapsed&quot;, both the label and the space are removed. Default is
&quot;visible&quot;. This argument can only be supplied by keyword.

checkbox

Whether or not the checkbox is checked.

The language that the code is written in, for syntax highlighting.
If <tt class="docutils literal">None</tt>, the code will be unstyled. Defaults to <tt class="docutils literal">&quot;python&quot;</tt>.
For a list of available <tt class="docutils literal">language</tt> values, see:
<a class="reference external" href="https://github.com/react-syntax-highlighter/react-syntax-highlighter/blob/master/AVAILABLE_LANGUAGES_PRISM.MD">https://github.com/react-syntax-highlighter/react-syntax-highlighter/blob/master/AVAILABLE_LANGUAGES_PRISM.MD</a>

language

An optional boolean indicating whether to show line numbers to the
left of the code block. Defaults to <tt class="docutils literal">False</tt>.

line_numbers

Display a code block with optional syntax highlighting.

code

A short label explaining to the user what this input is for.
The label can optionally contain Markdown and supports the following
elements: Bold, Italics, Strikethroughs, Inline Code, Emojis, and Links.
This also supports:
<ul class="simple">
<li>Emoji shortcodes, such as <tt class="docutils literal">:+1:</tt> and <tt class="docutils literal">:sunglasses:</tt>.
For a list of all supported codes,
see <a class="reference external" href="https://share.streamlit.io/streamlit/emoji-shortcodes">https://share.streamlit.io/streamlit/emoji-shortcodes</a>.</li>
<li>LaTeX expressions, by wrapping them in &quot;$&quot; or &quot;$$&quot; (the &quot;$$&quot;
must be on their own lines). Supported LaTeX functions are listed
at <a class="reference external" href="https://katex.org/docs/supported.html">https://katex.org/docs/supported.html</a>.</li>
<li>Colored text, using the syntax <tt class="docutils literal">:color[text to be colored]</tt>,
where <tt class="docutils literal">color</tt> needs to be replaced with any of the following
supported colors: blue, green, orange, red, violet, gray/grey, rainbow.</li>
</ul>
Unsupported elements are unwrapped so only their children (text contents) render.
Display unsupported elements as literal characters by
backslash-escaping them. E.g. <tt class="docutils literal">1\. Not an ordered list</tt>.
For accessibility reasons, you should never set an empty label (label=&quot;&quot;)
but hide it with label_visibility if needed. In the future, we may disallow
empty labels by raising an exception.

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.

An optional boolean, which disables the color picker if set to
True. The default is False. This argument can only be supplied by
keyword.

The visibility of the label. If &quot;hidden&quot;, the label doesn’t show but there
is still empty space for it above the widget (equivalent to label=&quot;&quot;).
If &quot;collapsed&quot;, both the label and the space are removed. Default is
&quot;visible&quot;. This argument can only be supplied by keyword.

color_picker

The selected color as a hex string.

Controls the number and width of columns to insert. Can be one of:
<ul class="simple">
<li>An integer that specifies the number of columns. All columns have equal
width in this case.</li>
<li>An iterable of numbers (int or float) that specify the relative width of
each column. E.g. <tt class="docutils literal">[0.7, 0.3]</tt> creates two columns where the first
one takes up 70% of the available with and the second one takes up 30%.
Or <tt class="docutils literal">[1, 2, 3]</tt> creates three columns where the second one is two times
the width of the first one, and the third one is three times that width.</li>
</ul>

spec

The size of the gap between the columns. Defaults to &quot;small&quot;. This
argument can only be supplied by keyword.

Insert containers laid out as side-by-side columns.
Inserts a number of multi-element containers laid out side-by-side and
returns a list of container objects.
To add elements to the returned containers, you can use &quot;with&quot; notation
(preferred) or just call methods directly on the returned object. See
examples below.
Columns can only be placed inside other columns up to one level of nesting.
<div class="admonition warning">
Warning
Columns cannot be placed inside other columns in the sidebar. This is only possible in the main area of the app.
</div>

columns

Insert a multi-element container.
Inserts an invisible container into your app that can be used to hold
multiple elements. This allows you to, for example, insert multiple
elements into your app out of order.
To add elements to the returned container, you can use &quot;with&quot; notation
(preferred) or just call methods directly on the returned object. See
examples below.

container

The data to edit in the data editor.
<div class="admonition note">
Note
<ul class="last simple">
<li>Styles from <tt class="docutils literal">pandas.Styler</tt> will only be applied to non-editable columns.</li>
<li>Mixing data types within a column can make the column uneditable.</li>
<li>Additionally, the following data types are not yet supported for editing:
complex, list, tuple, bytes, bytearray, memoryview, dict, set, frozenset,
datetime.timedelta, decimal.Decimal, fractions.Fraction, pandas.Interval,
pandas.Period, pandas.Timedelta.</li>
</ul>
</div>

Desired width of the data editor expressed in pixels. If None, the width will
be automatically determined.

Desired height of the data editor expressed in pixels. If None, the height will
be automatically determined.

If True, set the data editor width to the width of the parent container.
This takes precedence over the width argument. Defaults to False.

Whether to hide the index column(s). If None (default), the visibility of
index columns is automatically determined based on the data.

hide_index

Specifies the display order of columns. This also affects which columns are
visible. For example, <tt class="docutils literal">column_order=(&quot;col2&quot;, &quot;col1&quot;)</tt> will display 'col2'
first, followed by 'col1', and will hide all other non-index columns. If
None (default), the order is inherited from the original data structure.

column_order

Configures how columns are displayed, e.g. their title, visibility, type, or
format, as well as editing properties such as min/max value or step.
This needs to be a dictionary where each key is a column name and the value
is one of:
<ul class="simple">
<li><tt class="docutils literal">None</tt> to hide the column.</li>
<li>A string to set the display label of the column.</li>
<li>One of the column types defined under <tt class="docutils literal">st.column_config</tt>, e.g.
<tt class="docutils literal">st.column_config.NumberColumn(&quot;Dollar values”, format=”$ %d&quot;)</tt> to show
a column as dollar amounts. See more info on the available column types
and config options <a class="reference external" href="https://docs.streamlit.io/library/api-reference/data/st.column_config">here</a>.</li>
</ul>
To configure the index column(s), use <tt class="docutils literal">_index</tt> as the column name.

column_config

Specifies if the user can add and delete rows in the data editor.
If &quot;fixed&quot;, the user cannot add or delete rows. If &quot;dynamic&quot;, the user can
add and delete rows in the data editor, but column sorting is disabled.
Defaults to &quot;fixed&quot;.

num_rows

Controls the editing of columns. If True, editing is disabled for all columns.
If an iterable of column names is provided (e.g., <tt class="docutils literal">disabled=(&quot;col1&quot;, &quot;col2&quot;))</tt>,
only the specified columns will be disabled for editing. If False (default),
all columns that support editing are editable.

An optional string to use as the unique key for this 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 callback invoked when this data_editor's value changes.

Display a data editor widget.
The data editor widget allows you to edit dataframes and many other data structures in a table-like UI.
<div class="admonition warning">
Warning
When going from <tt class="docutils literal">st.experimental_data_editor</tt> to <tt class="docutils literal">st.data_editor</tt> in
1.23.0, the data editor's representation in <tt class="docutils literal">st.session_state</tt> was changed.
The <tt class="docutils literal">edited_cells</tt> dictionary is now called <tt class="docutils literal">edited_rows</tt> and uses a
different format (<tt class="docutils literal">{0: {&quot;column name&quot;: &quot;edited value&quot;}}</tt> instead of
<tt class="docutils literal">{&quot;0:1&quot;: &quot;edited value&quot;}</tt>). You may need to adjust the code if your app uses
<tt class="docutils literal">st.experimental_data_editor</tt> in combination with <tt class="docutils literal">st.session_state</tt>.&quot;
</div>

data_editor

The edited data. The edited data is returned in its original data type if
it corresponds to any of the supported return types. All other data types
are returned as a <tt class="docutils literal">pd.DataFrame</tt>.

The data to display.
If 'data' is a pandas.Styler, it will be used to style its
underlying 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.

Desired width of the dataframe expressed in pixels. If None, the width
will be automatically calculated based on the column content.

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

If True, set the dataframe width to the width of the parent container.
This takes precedence over the width argument.
This argument can only be supplied by keyword.

Configures how columns are displayed, e.g. their title, visibility, type, or
format. This needs to be a dictionary where each key is a column name and
the value is one of:
<ul class="simple">
<li><tt class="docutils literal">None</tt> to hide the column.</li>
<li>A string to set the display label of the column.</li>
<li>One of the column types defined under <tt class="docutils literal">st.column_config</tt>, e.g.
<tt class="docutils literal">st.column_config.NumberColumn(&quot;Dollar values”, format=”$ %d&quot;)</tt> to show
a column as dollar amounts. See more info on the available column types
and config options <a class="reference external" href="https://docs.streamlit.io/library/api-reference/data/st.column_config">here</a>.</li>
</ul>
To configure the index column(s), use <tt class="docutils literal">_index</tt> as the column name.

Display a dataframe as an interactive table.
This command works with dataframes from Pandas, PyArrow, Snowpark, and PySpark.
It can also display several other types that can be converted to dataframes,
e.g. numpy arrays, lists, sets and dictionaries.

dataframe

A short label explaining to the user what this date input is for.
The label can optionally contain Markdown and supports the following
elements: Bold, Italics, Strikethroughs, Inline Code, Emojis, and Links.
This also supports:
<ul class="simple">
<li>Emoji shortcodes, such as <tt class="docutils literal">:+1:</tt> and <tt class="docutils literal">:sunglasses:</tt>.
For a list of all supported codes,
see <a class="reference external" href="https://share.streamlit.io/streamlit/emoji-shortcodes">https://share.streamlit.io/streamlit/emoji-shortcodes</a>.</li>
<li>LaTeX expressions, by wrapping them in &quot;$&quot; or &quot;$$&quot; (the &quot;$$&quot;
must be on their own lines). Supported LaTeX functions are listed
at <a class="reference external" href="https://katex.org/docs/supported.html">https://katex.org/docs/supported.html</a>.</li>
<li>Colored text, using the syntax <tt class="docutils literal">:color[text to be colored]</tt>,
where <tt class="docutils literal">color</tt> needs to be replaced with any of the following
supported colors: blue, green, orange, red, violet, gray/grey, rainbow.</li>
</ul>
Unsupported elements are unwrapped so only their children (text contents) render.
Display unsupported elements as literal characters by
backslash-escaping them. E.g. <tt class="docutils literal">1\. Not an ordered list</tt>.
For accessibility reasons, you should never set an empty label (label=&quot;&quot;)
but hide it with label_visibility if needed. In the future, we may disallow
empty labels by raising an exception.

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.

A format string controlling how the interface should display dates.
Supports “YYYY/MM/DD” (default), “DD/MM/YYYY”, or “MM/DD/YYYY”.
You may also use a period (.) or hyphen (-) as separators.

An optional boolean, which disables the date input if set to True.
The default is False. This argument can only be supplied by keyword.

date_input

The current value of the date input widget.

Display a horizontal rule.
<div class="admonition note">
Note
You can achieve the same effect with st.write(&quot;---&quot;) or
even just &quot;---&quot; in your script (via magic).
</div>

divider

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

An optional boolean, which disables the download button if set to
True. The default is False. This argument can only be supplied by
keyword.

Display a download button widget.
This is useful when you would like to provide a way for your users
to download a file directly from your app.
Note that the data to be downloaded is stored in-memory while the
user is connected, so it's a good idea to keep file sizes under a
couple hundred megabytes to conserve memory.

download_button

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 &quot;with&quot; notation or just call methods directly on the returned object.
See examples below.

empty

An optional, keyword-only argument that specifies an emoji to use as
the icon for the alert. Shortcodes are not allowed, please use a
single character instead. E.g. &quot;🚨&quot;, &quot;🔥&quot;, &quot;🤖&quot;, etc.
Defaults to None, which means no icon is displayed.

icon

error

exception

A string to use as the header for the expander. The label can optionally
contain Markdown and supports the following elements: Bold, Italics,
Strikethroughs, Inline Code, Emojis, and Links.
This also supports:
<ul class="simple">
<li>Emoji shortcodes, such as <tt class="docutils literal">:+1:</tt> and <tt class="docutils literal">:sunglasses:</tt>.
For a list of all supported codes,
see <a class="reference external" href="https://share.streamlit.io/streamlit/emoji-shortcodes">https://share.streamlit.io/streamlit/emoji-shortcodes</a>.</li>
<li>LaTeX expressions, by wrapping them in &quot;$&quot; or &quot;$$&quot; (the &quot;$$&quot;
must be on their own lines). Supported LaTeX functions are listed
at <a class="reference external" href="https://katex.org/docs/supported.html">https://katex.org/docs/supported.html</a>.</li>
<li>Colored text, using the syntax <tt class="docutils literal">:color[text to be colored]</tt>,
where <tt class="docutils literal">color</tt> needs to be replaced with any of the following
supported colors: blue, green, orange, red, violet, gray/grey, rainbow.</li>
</ul>
Unsupported elements are unwrapped so only their children (text contents) render.
Display unsupported elements as literal characters by
backslash-escaping them. E.g. <tt class="docutils literal">1\. Not an ordered list</tt>.

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.
Inserts a container into your app that can be used to hold multiple elements
and can be expanded or collapsed by the user. When collapsed, all that is
visible is the provided label.
To add elements to the returned container, you can use &quot;with&quot; notation
(preferred) or just call methods directly on the returned object. See
examples below.
<div class="admonition warning">
Warning
Currently, you may not put expanders inside another expander.
</div>

expander

experimental_data_editor

A short label explaining to the user what this file uploader is for.
The label can optionally contain Markdown and supports the following
elements: Bold, Italics, Strikethroughs, Inline Code, Emojis, and Links.
This also supports:
<ul class="simple">
<li>Emoji shortcodes, such as <tt class="docutils literal">:+1:</tt> and <tt class="docutils literal">:sunglasses:</tt>.
For a list of all supported codes,
see <a class="reference external" href="https://share.streamlit.io/streamlit/emoji-shortcodes">https://share.streamlit.io/streamlit/emoji-shortcodes</a>.</li>
<li>LaTeX expressions, by wrapping them in &quot;$&quot; or &quot;$$&quot; (the &quot;$$&quot;
must be on their own lines). Supported LaTeX functions are listed
at <a class="reference external" href="https://katex.org/docs/supported.html">https://katex.org/docs/supported.html</a>.</li>
<li>Colored text, using the syntax <tt class="docutils literal">:color[text to be colored]</tt>,
where <tt class="docutils literal">color</tt> needs to be replaced with any of the following
supported colors: blue, green, orange, red, violet, gray/grey, rainbow.</li>
</ul>
Unsupported elements are unwrapped so only their children (text contents) render.
Display unsupported elements as literal characters by
backslash-escaping them. E.g. <tt class="docutils literal">1\. Not an ordered list</tt>.
For accessibility reasons, you should never set an empty label (label=&quot;&quot;)
but hide it with label_visibility if needed. In the future, we may disallow
empty labels by raising an exception.

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

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.

An optional boolean, which disables the file uploader if set to
True. The default is False. This argument can only be supplied by
keyword.

Display a file uploader widget.
By default, uploaded files are limited to 200MB. You can configure
this using the <cite>server.maxUploadSize</cite> config option. For more info
on how to set config options, see
<a class="reference external" href="https://docs.streamlit.io/library/advanced-features/configuration#set-configuration-options">https://docs.streamlit.io/library/advanced-features/configuration#set-configuration-options</a>

file_uploader

<ul class="simple">
<li>If accept_multiple_files is False, returns either None or
an UploadedFile object.</li>
<li>If accept_multiple_files is True, returns a list with the
uploaded files as UploadedFile objects. If no files were
uploaded, returns an empty list.</li>
</ul>
The UploadedFile class is a subclass of BytesIO, and therefore
it is &quot;file-like&quot;. This means you can pass them anywhere where
a file is expected.

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 &quot;Submit&quot; button.
A form is a container that visually groups other elements and
widgets together, and contains a Submit button. When the form's
Submit button is pressed, all widget values inside the form will be
sent to Streamlit in a batch.
To add elements to a form object, you can use &quot;with&quot; notation
(preferred) or just call methods directly on the form. See
examples below.
Forms have a few constraints:
<ul class="simple">
<li>Every form must contain a <tt class="docutils literal">st.form_submit_button</tt>.</li>
<li><tt class="docutils literal">st.button</tt> and <tt class="docutils literal">st.download_button</tt> cannot be added to a form.</li>
<li>Forms can appear anywhere in your app (sidebar, columns, etc),
but they cannot be embedded inside other forms.</li>
<li>Within a form, the only widget that can have a callback function is
<tt class="docutils literal">st.form_submit_button</tt>.</li>
</ul>

Function signature[source]
st.error(body, *, icon=None)
Parameters
body (str)	The error text to display.
icon (str or None)	An optional, keyword-only argument that specifies an emoji to use as the icon for the alert. Shortcodes are not allowed, please use a single character instead. E.g. "🚨", "🔥", "🤖", etc. Defaults to None, which means no icon is displayed.

st.error

Example

Still have questions?