Add a stateful button

[lukasmasuch]

Checklist

• I have searched the existing issues for similar feature requests.
• I added a descriptive title and summary to this issue.

Summary

Add a stateful mode for st.button so each click toggles between on and off, with the button visually showing its current state and returning a boolean value.

Why?

This would support compact on/off actions that should look like buttons rather than switches, without requiring manual st.session_state handling.

How?

For example, add a toggle=True parameter to st.button, or introduce a dedicated st.toggle_button API.

Additional Context

st.toggle covers the switch-style UI; this request is for the same stateful behavior with a button-style appearance.

[github-actions]

To help Streamlit prioritize this feature, react with a 👍 (thumbs up emoji) to the initial post.

Your vote helps us identify which enhancements matter most to our users.

[github-actions]

This is a feature request (enhancement) to add a stateful / toggle button to Streamlit. The proposal is for st.button to optionally maintain an on/off state across reruns—each click toggles the state, the button visually reflects whether it is "on" or "off", and it returns a boolean. The suggested API is either a toggle=True parameter on st.button or a dedicated st.toggle_button command. As the author notes, this is essentially the stateful behavior of st.toggle but rendered with a button-style appearance instead of a switch. This falls under st.button/widgets, so I've suggested type:enhancement, area:widgets, feature:st.button, and feature:st.toggle. No direct duplicate of a "stateful button" was found among open issues.

Related Issues

• #10997 - Show alternative st.toggle label based on its state: Closely related, as it also asks for a more expressive stateful on/off widget whose visual representation (label) changes with state—very similar to what a stateful/toggle button would provide.
• #11409 - Add a menu / dropdown button widget: Related request (from the same author) to expand the button family with a new button-style variant; worth considering together when designing new button APIs.
• #8822 - Add size/height parameter to buttons: Loosely related—both target "compact" button use cases and general enhancements to the st.button API surface.

---

This is an automated triage comment using claude-opus-4-8-thinking-xhigh. Please verify the suggested labels and related issues.