Display a form submit button.

When this button is clicked, all widget values inside the form will be sent to Streamlit in a batch.

Every form must have a form_submit_button. A form_submit_button cannot exist outside a form.

For more information about forms, check out our blog post.

Function signature

st.form_submit_button(label="Submit", help=None, on_click=None, args=None, kwargs=None)


label (str)

A short label explaining to the user what this button is for. Defaults to "Submit".

help (str or None)

A tooltip that gets displayed when the button is hovered over. Defaults to None.

on_click (callable)

An optional callback invoked when this button is clicked.

args (tuple)

An optional tuple of args to pass to the callback.

kwargs (dict)

An optional dict of kwargs to pass to the callback.



True if the button was clicked.

Was this page helpful?

editSuggest edits

Still have questions?

Our forums are full of helpful information and Streamlit experts.