> Deprecated: > Product subscription app extensions won't be supported as of December 3, 2025. You should migrate existing product subscription app extensions to [purchase options extensions](/docs/apps/build/purchase-options/purchase-options-extensions). **Note:** This component is not available in Product Subscription extensions. Option lists let you create grouped items. This can include single selection or multiple selection of options. Option lists are styled differently than choice lists and should not be used within a form, but as a standalone menu.
string
| Title to display above the list |
| options? | OptionDescriptor[]
| Array of options to be listed |
| selected | string[]
| Array of selected options |
| allowMultiple? | boolean
| Allow more than one option to be selected |
| onChange | (selected: string[]) => void
| Callback when selection changes |
### OptionDescriptor
| Name | Type | Description |
| --- | --- | --- |
| value | string
| Value of the option |
| label | string
| Display label for the option |
| disabled? | boolean
| Whether the option is disabled or not |
## Guidelines
| ✅ Do | 🛑 Don't |
| --------------------------------------------------------------------- | ----------------------- |
| Use OptionList to present either a single choice or multi choice list | Have only a single item |
For more guidelines, refer to Polaris' [Option List best practices](https://polaris.shopify.com/components/lists/option-list#best-practices).