---
title: Choice list
description: |-
  The choice list component presents multiple options for single or multiple selections. Use it when merchants need to choose from a defined set of options, such as filtering results or collecting preferences.

  The component supports both single selection (radio button behavior) and multiple selection (checkbox behavior) modes. It includes configurable labels, help text, and validation. For compact dropdown selection with four or more options, use [select](/docs/api/admin-extensions/2026-01/web-components/forms/select).
api_version: 2026-01
api_name: admin-extensions
source_url:
  html: https://shopify.dev/docs/api/admin-extensions/latest/polaris-web-components/forms/choice-list
  md: https://shopify.dev/docs/api/admin-extensions/latest/polaris-web-components/forms/choice-list.md
---

Choice list

Not supported in this version.