-
Notifications
You must be signed in to change notification settings - Fork 4k
Description
Checklist
- I have searched the existing issues for similar feature requests.
- I added a descriptive title and summary to this issue.
Summary
Currently, the helper texts displayed by st.file_uploader (e.g., “Drag and drop files here” and the file type/size hint) are not customizable. This limits flexibility for applications that require domain-specific wording, regulatory disclaimers, or improved UX clarity. Allowing developers to customize these texts would significantly improve usability and accessibility.
Why?
Many Streamlit apps are used in professional, clinical, or enterprise contexts where default generic UI text is not sufficient.
For example, applications may need to:
-
add regulatory or compliance-related wording,
-
clarify how uploaded files are processed,
-
localize text for non-English users,
-
provide more user-friendly instructions for non-technical audiences.
Currently, developers cannot modify these texts without resorting to UI workarounds or custom components.
How?
st.file_uploader(
"Upload file",
text="Drop your files here or click Browse",
footer_text="Accepted formats: MP3, WAV, PDF. Max size: 2GB per file."
)
Additional Context
This feature request comes from building user-facing applications where clear, customizable messaging is essential, and where language control is a strict requirement—particularly for non-technical users and regulated domains such as healthcare, research, and education.