●Change8

Migrating to Streamlit 1.47.0

Version 1.47.0 introduces 1 breaking change. This guide details how to update your code.

Released: 7/16/2025

1
Breaking Changes
5
Migration Steps
38
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

st.htmlst.metricst.feedbackst.pillsst.segmented_controlst.codest.multiselectst.dialogLinkColumnnumber columnprogress columnst.date_inputst.cache_datast.column_configst.text_areast.about_dialogst.dataframepandas.Stylerst.set_page_configst.navigationevent based watcherst.expanderst.containertimerst.formunsafe_allow_htmlHeader componentAltair chartsVega chartssidebarglide data griddataframe error indicatorfile watchercolumn visibility menuVitetooltipsscript cachest.chat_input

Breaking Changes

●Issue #1

Stretch height and fixed height in vertical layouts were removed from the public API, causing existing layouts that relied on these properties to break. Update your code to use explicit height parameters (e.g., the new height argument on st.metric, st.text_area, etc.) or adjust the layout logic accordingly.

Migration Steps

  1. 1
    Replace any usage of the removed stretch height property with explicit height arguments on affected components (e.g., st.metric, st.text_area, etc.).
  2. 2
    Review layout code that relied on fixed height behavior in vertical layouts and adjust to the new height parameters.
  3. 3
    If you used the deprecated stretch height API, remove those calls and test the UI for expected sizing.
  4. 4
    Update any custom theming that referenced removed properties (e.g., isTransparentBackground) to use the new theming options such as headingFontWeights or headingFontSizes.
  5. 5
    Verify that st.set_page_config calls that previously omitted sidebar/layout configs still work, as None is now accepted.

Release Summary

This release introduces numerous layout and theming enhancements, adds many new configuration options, and fixes a wide range of bugs, while removing the stretch height API which requires migration of existing vertical layouts.

Need More Details?

View the full release notes and all changes for Streamlit 1.47.0.

View Full Changelog