streamlit-survey 1.1.0

Installation

Streamlit-Survey can be installed from PyPI:

pip install streamlit-survey

Example

Simple paged survey example with a conditional structure and a submit button:

Error auditing toy example for machine learning applications:

Usage

The streamlit_survey package contains a StreamlitSurvey class that can be used to create and manage survey components:

import streamlit_survey as ss

survey = ss.StreamlitSurvey()

Components can be added to the survey using functions similar to Streamlit’s input functions:

Features

Survey components are similar to Streamlit inputs, but they have additional features that make them suitable for surveys:

• Questions and responses are automatically saved.

• Component states and previous responses are automatically restored and displayed based on survey data.

• Survey can be saved to and loaded from JSON files.

• Custom survey components can be created for more complex input UI and functionality.

• Customizable paging and option to show a progress bar.

Read the docs:

Streamlit-Survey Documentation

License

• Commons Clause + Apache 2.0

1.1.0 (2025-09-16)

• Add support for feedback component.

• Add support for segmented_control component.

• Update Streamlit dependency to 1.40.0.

1.0.0 (2024-08-08)

• Fix button customization in paged surveys.

• Add progress bar option to pages.

• Add option to pass a list to Page’s constructor, in order to both have the current page number and an associated value.

• Add survey download button and file importer.

• Add “widget_key” to survey data to help restore survey data for displayed widgets.

0.1.0 (2023-03-23)

• First release.