Skip to content

Allow customization of st.file_uploader UI text (drag-and-drop label and file limit text) #13500

@csipapicsa

Description

@csipapicsa

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:localizationRelated to internationalization and localizationfeature:st.file_uploaderRelated to the `st.file_uploader` widgettype:enhancementRequests for feature enhancements or new features

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions