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 "just plot this" 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.

Function signature

st.area_chart(data=None, *, x=None, y=None, width=0, height=0, use_container_width=True)

Parameters

data (pandas.DataFrame, pandas.Styler, pyarrow.Table, numpy.ndarray, Iterable, or dict)

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

x (str or None)

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.

y (str, sequence of str, or None)

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.

width (int)

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

height (int)

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

use_container_width (bool)

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.

Example

chart_data = pd.DataFrame(
    np.random.randn(20, 3),
    columns=['a', 'b', 'c'])

st.area_chart(chart_data)
(view standalone Streamlit app)

Was this page helpful?

editSuggest edits
forum

Still have questions?

Our forums are full of helpful information and Streamlit experts.