Select

Add a select input to your app to allow users to choose from a list of many options.

Options

Select options can be added manually or pulled from a remote source. The input ID in the URL template for your select input is replaced with the selected option’s value.

Manual Options

Select the "manual" options type, then add options to your select input and set a default option.

Remote Options

Select the "remote" options type, then specify the options URL and any required headers. The API must return a JSON response in the following format.

[
  {
    "label": "my label",
    "value": "my-value",
  },
  {
    "label": "my second label",
    "value": "my-second-value",
  }
]

A default option can be set by setting default to true for any given option.

[
  {
    "label": "my label",
    "value": "my-value",
  },
  {
    "label": "my second label",
    "value": "my-second-value",
    "default": true
  }
]

Validation

The select input supports the following validation options:

  • Required: Prevent your app from rendering until an input value is provided.

Appearance

Add helper text to provide helpful context or link to a support article for additional instructions.

Next Steps


Was this article helpful to you?
GitHubProvide feedback

Last edited on January 17, 2024.
GitHubEdit this page