Show API reference for

Display an informational message.

Function signature[source]

st.info(body, *, icon=None, width="stretch")

Parameters

body (str)

The text to display as 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.

If icon is None, and body begins with an emoji or Material icon shortcode, Streamlit will extract it and display it slightly enlarged, as if it were passed to icon. If body contains multiple icons, or you want to override this behavior, you can insert a null Markdown directive like :red[] before your leading icon.

icon (str or None)

An optional emoji or icon to display next to the alert. If icon is None (default), Streamlit attempts to extract a leading emoji or Material icon shortcode from body. If found, the icon is displayed and removed from the body text. If no leading icon is found, no icon is displayed. If icon is a string, it takes precedence over any icon in the body, and the following options are valid:

  • A single-character emoji. For example, you can set icon="🚨" or icon="🔥". Emoji short codes are not supported.

  • An icon from the Material Symbols library (rounded style) in the format ":material/icon_name:" where "icon_name" is the name of the icon in snake case.

    For example, icon=":material/thumb_up:" will display the Thumb Up icon. Find additional icons in the Material Symbols font library.

  • "spinner": Displays a spinner as an icon.

width ("stretch" or int)

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

  • "stretch" (default): The width of the element matches 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.

Examples

import streamlit as st

st.info('This is a purely informational message', icon="ℹ️")
forum

Still have questions?

Our forums are full of helpful information and Streamlit experts.