[Go to site: main page, start]
Show API reference for
  1. Contents
  2. st.table
  3. DeltaGenerator.add_rows
star

Tip

Static tables with st.table are the most basic way to display dataframes. For the majority of cases, we recommend using st.dataframe to display interactive dataframes, and st.data_editor to let users edit dataframes.

st.table

Display a static table.

While st.dataframe is geared towards large datasets and interactive data exploration, st.table is useful for displaying small, styled tables without sorting or scrolling. For example, st.table may be the preferred way to display a confusion matrix or leaderboard. Additionally, st.table supports Markdown.

Function signature[source]

st.table(data=None, *, border=True, width="stretch", height="content", hide_index=None, hide_header=None)

Parameters

data (Anything supported by st.dataframe)

The table data.

All cells including the index and column headers can optionally contain GitHub-flavored Markdown. Syntax information can be found at: https://github.github.com/gfm.

See the body parameter of st.markdown for additional, supported Markdown directives.

border (bool or "horizontal")

Whether to show borders around the table and between cells. This can be one of the following:

  • True (default): Show borders around the table and between cells.
  • False: Don't show any borders.
  • "horizontal": Show only horizontal borders between rows.

width ("stretch", "content", or int)

The width of the table element. This can be one of the following:

  • "stretch" (default): The width of the element matches the width of the parent container.
  • "content": The width of the element matches the width of its content, but doesn't exceed the width of the parent container.
  • An integer specifying the width in pixels: The element has a fixed width. If the specified width is greater than the width of the parent container, the width of the element matches the width of the parent container.

Row index columns are sticky only when the content overflows a specified integer width. Otherwise, they aren't sticky.

height ("stretch", "content", or int)

The height of the table element. This can be one of the following:

  • "content" (default): The height of the element matches the height of its content, showing all rows.
  • "stretch": The height of the element expands to fill the available vertical space in its parent container. When multiple elements with stretch height are in the same container, they share the available vertical space evenly.
  • An integer specifying the height in pixels: The element has a fixed height. If the table content exceeds this height, scrolling is enabled with sticky headers.

hide_index (bool or None)

Whether to hide the index column. This can be one of the following values:

  • None (default): Hide the index column if it's a default RangeIndex. Show custom indices.
  • True: Always hide the index column.
  • False: Always show the index column.

hide_header (bool or None)

Whether to hide the column header row. This can be one of the following values:

  • None (default): Auto-hide headers for data formats without user-defined column names, like dict, list, and numpy.ndarray. Show headers for data with explicit column names, like pandas.DataFrame.
  • True: Always hide the column header row, including all levels of MultiIndex headers.
  • False: Always show the column header row.

Examples

Example 1: Display a confusion matrix as a static table

streamlit_app.py
import pandas as pd
import streamlit as st

confusion_matrix = pd.DataFrame(
    {
        "Predicted Cat": [85, 3, 2, 1],
        "Predicted Dog": [2, 78, 4, 0],
        "Predicted Bird": [1, 5, 72, 3],
        "Predicted Fish": [0, 2, 1, 89],
    },
    index=["Actual Cat", "Actual Dog", "Actual Bird", "Actual Fish"],
)
st.table(confusion_matrix)
Built with Streamlit 🎈

Example 2: Display a product leaderboard with Markdown and horizontal borders

streamlit_app.py
import streamlit as st

product_data = {
    "Product": [
        ":material/devices: Widget Pro",
        ":material/smart_toy: Smart Device",
        ":material/inventory: Premium Kit",
    ],
    "Category": [":blue[Electronics]", ":green[IoT]", ":violet[Bundle]"],
    "Stock": ["🟢 Full", "🟡 Low", "🔴 Empty"],
    "Units sold": [1247, 892, 654],
    "Revenue": [125000, 89000, 98000],
}
st.table(product_data, border="horizontal")
Built with Streamlit 🎈

Example 3: Display a scrollable table with fixed height

streamlit_app.py
import pandas as pd
import streamlit as st
from numpy.random import default_rng as rng

df = pd.DataFrame(
    rng(0).standard_normal((50, 5)), columns=["A", "B", "C", "D", "E"]
)
st.table(df, height=300)

Example 4: Display key-value data

streamlit_app.py
import streamlit as st

st.table(
    {
        ":material/folder: Project": "**Streamlit** - The fastest way to build data apps",
        ":material/code: Repository": "[github.com/streamlit/streamlit](https://github.com/streamlit/streamlit)",
        ":material/new_releases: Version": ":gray-badge[1.45.0]",
        ":material/license: License": ":green-badge[Apache 2.0]",
        ":material/group: Maintainers": ":blue-badge[Core Team] :violet-badge[Community]",
    },
    border="horizontal",
    width="content",
)
Built with Streamlit 🎈

Example 5: Display a minimal table without index and headers

streamlit_app.py
import pandas as pd
import streamlit as st

df = pd.DataFrame({"Name": ["Alice", "Bob"], "Age": [25, 30]})
st.table(df, hide_index=True, hide_header=True)
Built with Streamlit 🎈

DeltaGenerator.add_rows

priority_high

Warning

This method does not exist in version 1.58.0 of Streamlit.

arrow_backPrevious: st.column_configarrow_forwardNext: st.metric
forum

Still have questions?

Our forums are full of helpful information and Streamlit experts.