Release 1.50.0 (#1346)

* Update streamlit.json

* Fix missing deprecation in 1.49.0 parse error

* Add MultiselectColumn

* Remove accidental post-cutoff change

* Update streamlit.json

* Release notes

* Remove smart quotes

* Inline font definitions

* Fix tabs and audio input example headers

* Typos

* Color palette

* Update config.toml

* Bump streamlit version for apps

* Cheat sheet

* What's new

* Apply suggestions from code review

Co-authored-by: Copilot <[email protected]>

---------

Co-authored-by: Copilot <[email protected]>

Author: sfc-gh-dmatthews

content/develop/api-reference/configuration/config-toml.md

@@ -76,6 +76,19 @@ SelectboxColumn("App Category", options=["🤖 LLM", "📈 Data Viz"])
 
 </RefCard>
 
+<RefCard href="/develop/api-reference/data/st.column_config/st.column_config.multiselectcolumn">
+<Image pure alt="screenshot" src="/images/api/column_config.multiselectcolumn.jpg" />
+
+<h4>Multiselect column</h4>
+
+Configure a multiselect column.
+
+```python
+MultiselectColumn("App Category", options=["LLM", "Visualization"])
+```
+
+</RefCard>
+
 <RefCard href="/develop/api-reference/data/st.column_config/st.column_config.datetimecolumn">
 <Image pure alt="screenshot" src="/images/api/column_config.datetimecolumn.jpg" />
 

content/develop/api-reference/data/column_config/_index.md

@@ -0,0 +1,8 @@
+---
+title: st.column_config.MultiselectColumn
+slug: /develop/api-reference/data/st.column_config/st.column_config.multiselectcolumn
+description: st.column_config.MultiselectColumn configures multiselect columns for editing categorical columns or columns with a predefined set of possible values.
+keywords: st.column_config.MultiselectColumn, multiselect column, dropdown column, select options, dropdown menu, choice column, option selection, dataframe dropdown
+---
+
+<Autofunction function="streamlit.column_config.MultiselectColumn" />

content/develop/api-reference/data/column_config/multiselectcolumn.md

@@ -18,13 +18,13 @@ For all configuration options that accept a color, you can specify the value wit
 
 <Tip>
 
-Although you can specify an alpha value for your colors, this isn't recommended. Streamlit adjusts the alpha value of colors to ensure contextually appropriate shading between background and foreground.
+Although you can specify an alpha value for your colors, this isn't necessary for most options. Streamlit adjusts the alpha value of colors to ensure contextually appropriate shading between background and foreground.
 
 </Tip>
 
 ## Default Streamlit colors
 
-Streamlit comes with two preconfigured themes: light and dark. If you don't specify any theme configuration options, Streamlit will attempt to use the preconfigured theme that best matches each user's browser settings.
+Streamlit comes with two preconfigured themes: light and dark. If you don't specify any theme configuration options, Streamlit will attempt to use the preconfigured theme that best matches each user's browser settings. These themes feature a red primary color in addition to a basic color palette (red, orange, yellow, green, blue, violet, and gray/grey) for elements like colored Markdown text.
 
 ## Color and border configuration options
 
@@ -51,9 +51,30 @@ The following configuration options can be set separately for the sidebar by usi
 - `theme.dataframeBorderColor`
 - `theme.dataframeHeaderBackgroundColor`
 - `theme.showWidgetBorder`
+- All color palette options
 
 For brevity, on the rest of this page, theming configuration options will not include the `theme.` or `theme.sidebar.` prefix.
 
+### Basic color palette
+
+Various elements in Streamlit use or let you choose from a predefined palette of colors: red, orange, yellow, green, blue, violet, and gray/grey. These are some of the elements that use this basic color palette:
+
+- Markdown text and background color (including `st.badge`).
+- `st.metric` sparklines and deltas.
+- Dataframe chart columns.
+- Chat message avatars.
+- Alert elements like `st.success` and `st.warning`.
+
+For each color in the palette, you can define a base color, background color, and text color. If you only define a base color, Streamlit adjusts lightness/darkness and opacity to automatically provide a corresponding background and text color. However, you can manually define each of them, too. These are the color palette options:
+
+- `redColor`, `redBackgroundColor`, `redTextColor`
+- `orangeColor`, `orangeBackgroundColor`, `orangeTextColor`
+- `yellowColor`, `yellowBackgroundColor`, `yellowTextColor`
+- `greenColor`, `greenBackgroundColor`, `greenTextColor`
+- `blueColor`, `blueBackgroundColor`, `blueTextColor`
+- `violetColor`, `violetBackgroundColor`, `violetTextColor`
+- `grayColor`, `grayBackgroundColor`, `grayTextColor`
+
 ### `primaryColor`
 
 `primaryColor` defines the accent color most often used throughout your Streamlit

content/develop/concepts/configuration/theming-colors-and-borders.md

@@ -52,9 +52,25 @@ font = "serif"
 font = "sans-serif"
 ```
 
-## Loading alternative fonts
+## Externally hosted fonts
 
-To use an alternative font in your app, you must declare the font in `config.toml` under `[[theme.fontFaces]]`. For multiple alternative fonts, declare multiple `[[theme.fontFaces]]` tables in your configuration file. You can self-host your font by using Streamlit static file serving, or you can point to a publicly hosted font file.
+If you use a font service like Google Fonts or Adobe Fonts, you can use those fonts directly by encoding their font family (name) and CSS URL into a single string of the form `{font_name}:{css_url}`. If your font family includes a space, use inner quotes on the font family. In the following `config.toml` example, Streamlit uses Nunito font for all text except code, which is Space Mono instead. Space Mono has inner quotes because it has a space.
+
+```toml
+[theme]
+font = "Nunito:https://fonts.googleapis.com/css2?family=Nunito&display=swap"
+codeFont = "'Space Mono':https://fonts.googleapis.com/css2?family=Space+Mono&display=swap"
+```
+
+<Important>
+
+If you configure your app to include any third-party integrations, including externally hosted fonts, your app may transmit user data (for example, IP addresses) to external servers. As the app developer, you are solely responsible for notifying your users about these third-party integrations, providing access to relevant privacy policies, and ensuring compliance with all applicable data protection laws and regulations.
+
+</Important>
+
+## Hosting alternative fonts
+
+If you have font files that you want to host with your app, you must declare the font in `config.toml` under `[[theme.fontFaces]]`. For multiple alternative fonts, declare multiple `[[theme.fontFaces]]` tables in your configuration file. You can self-host your font by using Streamlit static file serving, or you can point to a publicly hosted font file.
 
 <Important>
 
@@ -176,38 +192,24 @@ project_directory/
 └── streamlit_app.py
 ```
 
-### Example 3: Define an alternative font with fallbacks
-
-If you don't want to download and host your font files with your app, you can point to externally hosted font files. If your files aren't hosted with your app, it's recommended to declare fallback fonts.
-
-<Important>
+## Font fallbacks
 
-If you configure your app to include any third-party integrations, including externally hosted fonts, your app may transmit user data (for example, IP addresses) to external servers. As the app developer, you are solely responsible for notifying your users about these third-party integrations, providing access to relevant privacy policies, and ensuring compliance with all applicable data protection laws and regulations.
+If you use complicated font that might not be compatible with all browsers, or if you are using externally hosted fonts, it's best practice to include font fallbacks.
 
-</Important>
+### Example 3: Define an alternative font with fallbacks
 
 In your configuration file, wherever you declare a default font, you can use a comma-separated list of fonts instead. The font (or comma-separated list of fonts) is passed to the CSS [`font-family`](https://developer.mozilla.org/en-US/docs/Web/CSS/font-family) property.
 
-You can always include one of Streamlit's default fonts as a final fallback. The following example uses [Nunito](https://fonts.google.com/specimen/Nunito) font. The configuration file points to the Google-hosted font files and identifies Streamlit's built-in font as the backup.
+You can always include one of Streamlit's default fonts as a final fallback. The following example uses [Nunito](https://fonts.google.com/specimen/Nunito) and [Space Mono](https://fonts.google.com/specimen/Space+Mono) fonts. The configuration file points to the Google-hosted font files and identifies Streamlit's built-in font as the backup.
 
 A line-by-line explanation of this example is available in a [tutorial](/develop/tutorials/configuration-and-theming/external-fonts).
 
 `.streamlit/config.toml`:
 
 ```toml
-[[theme.fontFaces]]
-family="Nunito"
-url="https://fonts.gstatic.com/s/nunito/v31/XRXX3I6Li01BKofIMNaDRs7nczIH.woff2"
-style="italic"
-weight="200 1000"
-[[theme.fontFaces]]
-family="Nunito"
-url="https://fonts.gstatic.com/s/nunito/v31/XRXV3I6Li01BKofINeaBTMnFcQ.woff2"
-style="normal"
-weight="200 1000"
-
 [theme]
-font="Nunito, sans-serif"
+font="Nunito:https://fonts.googleapis.com/css2?family=Nunito:ital,wght@0,200..1000;1,200..1000, sans-serif"
+codeFont="'Space Mono':https://fonts.googleapis.com/css2?family=Space+Mono:ital,wght@0,400;0,700;1,400;1,700&display=swap, monospace"
 ```
 
 <Tip>

content/develop/concepts/configuration/theming-fonts.md

@@ -25,6 +25,7 @@ The following options can be configured separately for the main body of your app
 - **Background color**: Set the color of app, widget, code block, and dataframe header backgrounds.
 - **Border radius**: Set the roundness of elements and widgets.
 - **Border color**: Set the color and visibility of element, widget, sidebar, and dataframe borders.
+- **Basic color palette**: Set the color palette (red, orange, yellow, green, blue, violet, and gray/grey) for things like colored Markdown text and sparklines.
 
 ## Example themes
 

content/develop/concepts/configuration/theming.md

@@ -7,7 +7,7 @@ keywords: API cheat sheet, Streamlit API, widgets, layout, data display, utility
 
 # Streamlit API cheat sheet
 
-This is a summary of the docs for the latest version of Streamlit, [v1.49.0](https://pypi.org/project/streamlit/1.49.0/).
+This is a summary of the docs for the latest version of Streamlit, [v1.50.0](https://pypi.org/project/streamlit/1.50.0/).
 
 <Masonry>
 

content/develop/quick-references/api-cheat-sheet.md

@@ -9,6 +9,64 @@ keywords: changelog, release notes, version history
 
 This page contains release notes for Streamlit versions released in 2025. For the latest version of Streamlit, see [Release notes](/develop/quick-reference/release-notes).
 
+## **Version 1.50.0**
+
+_Release date: September 23, 2025_
+
+**Highlights**
+
+- 🤹 Introducing [`MultiselectColumn`](/develop/api-reference/data/st.column_config/st.column_config.multiselectcolumn) to configure colorful, editable lists in your dataframes.
+- 🎨 Announcing [color palette](/develop/concepts/configuration/theming-customize-colors-and-borders#basic-color-palette) configuration options to set the exact shade of red, orange, yellow, green, blue, violet, and grey to use in Markdown, status elements, sparklines, `st.metric`, and `st.badge`.
+- 📊 [`st.bar_chart`](/develop/api-reference/charts/st.bar_chart) has a new `sort` parameter for conveniently sorting your bars.
+
+**Notable Changes**
+
+- 🔑 To prevent widgets from resetting when you change a parameter, widgets are transitioning to an identity based only on their keys (if provided). The following widgets use only their key for their identity:
+  - `st.button`
+  - `st.download_button`
+  - `st.checkbox`
+  - `st.toggle`
+  - `st.text_area`
+  - `st.text_input`
+  - `st.number_input`
+  - `st.time_input`
+  - `st.date_input`
+  - `st.selectbox`
+  - `st.multiselect`
+  - Custom components
+- 🖌️ You can configure the color of [chart columns](/develop/api-reference/data/st.column_config/st.column_config.areachartcolumn).
+- 🔢 [`st.metric`](/develop/api-reference/data/st.metric) supports `decimal.Decimal` types ([#12377](https://github.com/streamlit/streamlit/pull/12377), [#12308](https://github.com/streamlit/streamlit/issues/12308)). Thanks, [aebrahim](https://github.com/aebrahim)!
+- 🎤 You can specify the sample rate for [`st.audio_input`](/develop/api-reference/widgets/st.audio_input), and the default sample rate has been reduced to 16000 Hz.
+- ⚙️ For clarity, in [`st.plotly_chart`](/develop/api-reference/charts/st.plotly_chart), `**kwargs` is deprecated and replaced by `config` ([#12291](https://github.com/streamlit/streamlit/pull/12291), [#12280](https://github.com/streamlit/streamlit/issues/12280)). Thanks, [zyfy29](https://github.com/zyfy29)!
+- 📈 [`st.line_chart`](/develop/api-reference/charts/st.line_chart) and [`st.graphviz_chart`](/develop/api-reference/charts/st.graphviz_chart) have `width` parameters to use with flex containers.
+- 🔲 You can configure [`st.table`](/develop/api-reference/data/st.table) borders to show all, only horizontal, or no lines.
+- 📂 You can specify a default tab in [`st.tabs`](/develop/api-reference/layout/st.tabs).
+- 🌐 To use hosted fonts from providers like Google and Adobe, you can declare externally hosted fonts with a URL to their CSS file in `theme.font`, `theme.headingFont`, and `theme.codeFont`.
+
+**Other Changes**
+
+- 🧹 `**kwargs` has been removed from `st.write` ([#12375](https://github.com/streamlit/streamlit/pull/12375), [#12374](https://github.com/streamlit/streamlit/issues/12374)).
+- ⏱️ To prevent browser defaults from invalidating caches too soon, cache headers include the `max-age` and `immutable` directives ([#12420](https://github.com/streamlit/streamlit/pull/12420)).
+- 👽 Material icons were updated ([#12473](https://github.com/streamlit/streamlit/pull/12473), [#12535](https://github.com/streamlit/streamlit/pull/12535)).
+- 🦋 Visual tweaks ([#12348](https://github.com/streamlit/streamlit/pull/12348), [#12367](https://github.com/streamlit/streamlit/pull/12367)).
+- 👻 Bug fix: To correct a sequential navigation regression for `st.number_input`, some internal refactoring was reverted ([#12547](https://github.com/streamlit/streamlit/pull/12547), [#12526](https://github.com/streamlit/streamlit/issues/12526)).
+- 🦀 Bug fix: Custom components respect zero-size dimensions ([#12479](https://github.com/streamlit/streamlit/pull/12479), [#12454](https://github.com/streamlit/streamlit/issues/12454)).
+- 🦎 Bug fix: Images respect center alignment in containers ([#12495](https://github.com/streamlit/streamlit/pull/12495), [#12435](https://github.com/streamlit/streamlit/issues/12435)).
+- 🐌 Bug fix: If you use an empty string as a section label in top navigation, those pages will display individually before the collapsible sections ([#12247](https://github.com/streamlit/streamlit/pull/12247), [#12243](https://github.com/streamlit/streamlit/issues/12243)).
+- 🕸️ Bug fix: To fix a performance regression, dataframes use `.iat[]` instead of `.iloc[]` internally ([#12422](https://github.com/streamlit/streamlit/pull/12422), [#10952](https://github.com/streamlit/streamlit/issues/10952)).
+- 🦗 Bug fix: `st.data_editor` accepts Shift+Enter for multiline entry in a cell ([#12401](https://github.com/streamlit/streamlit/pull/12401), [#12386](https://github.com/streamlit/streamlit/issues/12386)).
+- 🦂 Bug fix: To make `st.pdf` more compatible on Windows, MIME types were updated ([#12399](https://github.com/streamlit/streamlit/pull/12399), [#12387](https://github.com/streamlit/streamlit/issues/12387)). Thanks, [geoextra](https://github.com/geoextra)!
+- 🦟 Bug fix: To prevent long-word overflow, words are forced to break if they exceed their container's width ([#12370](https://github.com/streamlit/streamlit/pull/12370), [#12366](https://github.com/streamlit/streamlit/issues/12366)).
+- 🦠 Bug fix: Hiding all dataframe columns won't raise a TypeError ([#12361](https://github.com/streamlit/streamlit/pull/12361), [#12227](https://github.com/streamlit/streamlit/issues/12227)).
+- 🪰 Bug fix: `st.logo` doesn't dislocate the sidebar collapse button ([#12329](https://github.com/streamlit/streamlit/pull/12329), [#12326](https://github.com/streamlit/streamlit/issues/12326)).
+- 🪳 Bug fix: When using `accept_new_options=True` with `st.multiselect`, mobile users can access their keyboards ([#12330](https://github.com/streamlit/streamlit/pull/12330)).
+- 🕷️ Bug fix: `st.components.v1.html` ignores fractional pixels in `width` ([#12354](https://github.com/streamlit/streamlit/pull/12354), [#12340](https://github.com/streamlit/streamlit/issues/12340)).
+- 🐞 Bug fix: `st.number_input` correctly accepts keyed entries ([#12351](https://github.com/streamlit/streamlit/pull/12351), [#12349](https://github.com/streamlit/streamlit/issues/12349)).
+- 🐝 Bug fix: Markdown images maintain their aspect ratio when constrained ([#12343](https://github.com/streamlit/streamlit/pull/12343)).
+- 🐜 Bug fix: `st.date_input` is inclusive of min and max values ([#12295](https://github.com/streamlit/streamlit/pull/12295), [#12293](https://github.com/streamlit/streamlit/issues/12293)).
+- 🪲 Bug fix: Maintain image proportions in fullscreen mode for all width settings ([#12235](https://github.com/streamlit/streamlit/pull/12235)).
+- 🐛 Bug fix: Markdown code blocks don't overflow when used in labels ([#12175](https://github.com/streamlit/streamlit/pull/12175), [#12149](https://github.com/streamlit/streamlit/issues/12149)).
+
 ## **Version 1.49.0**
 
 _Release date: August 26, 2025_