●Change8

Migrating to Streamlit 1.48.0

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

Released: 8/5/2025

1
Breaking Changes
6
Migration Steps
19
Affected Symbols

⚠️ Check Your Code

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

st.containerst.columnsst.popoverst.buttonst.expanderst.statusst.dialogst.sliderst.feedbackst.line_chartst.helpst.logoutcodeFontWeightst.sidebarst.date_inputst.pillsst.segmented_controlst.top_navigationst.scrollbar

Breaking Changes

●Issue #1

Added width/height parameters to st.container and st.columns, which may break existing code that relied on the previous signatures. Update calls to include the new parameters or adjust usage.

Migration Steps

  1. 1
    Update any calls to st.container and st.columns to accommodate the new width and height parameters.
  2. 2
    If you use st.popover or button elements, add the new width parameter where appropriate.
  3. 3
    Review layout code that relies on default container alignment; the new direction, gap, and alignment options may affect layout.
  4. 4
    Ensure your Altair version is not 5.4.0 or 5.4.1; downgrade or upgrade to a compatible version as specified in the updated constraints.
  5. 5
    If you rely on the previous behavior of st.help header colors, note the change to use bgMix.
  6. 6
    Adjust any custom toolbar implementations to account for the MINIMAL mode menu item visibility fix.

Release Summary

Streamlit 1.48.0 introduces extensive layout enhancements and new UI designs, while fixing numerous bugs and updating Altair constraints; developers should adjust to the new width/height parameters in layout APIs.

Need More Details?

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

View Full Changelog