---
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 offers multiple layout variants including list, inline, block, and grid formats to suit different space constraints and visual requirements.
api_version: 2026-01
api_name: pos-ui-extensions
source_url:
  html: https://shopify.dev/docs/api/pos-ui-extensions/latest/polaris-web-components/forms/choice-list
  md: https://shopify.dev/docs/api/pos-ui-extensions/latest/polaris-web-components/forms/choice-list.md
---

Choice list

Not supported in this version.