The select input provides creators with a dropdown menu containing predefined options. It’s ideal for scenarios where you need to present a fixed set of choices such as categories, sizes, or configuration options. The selected value is hidden from creators but passed to your plugin for processing.
If you want to generate dynamic options, please use a search input instead.
Compatibility
Plugin type
Availability
Additional notes
Content blocks
Media source
Available as part of the preset filter and sort group functionality. Check media source documentation for more details.
Properties
string
required
select - the type of the component
string
required
A unique internal-only identifier that is posted to an app’s plugin server to share values inputted by the creator
string
required
Creator-facing identifier that is shown in the plugin environment
array
required
Array of objects containing label-value pairs for the dropdown options
string
Placeholder text displayed when no option is selected
string
Default option value that is pre-selected when the component first loads
boolean
Determines whether the creator must make a selection before proceeding
string
Brief creator-facing explanation that clarifies the component’s purpose and usage. (256 character limit. Supports markdown: [text](url), **bold**, and *italic*)
object array
Allows for the field to be shown conditionally. dependent on other fields. See dependencies page for more details.
Show properties
string
required
Name of the dependent field
string
Value for the dependent field required to show this field. To show when any value is inputted, leave out this property.