---
title: Chip
description: >-
  The chip component displays static labels, categories, or attributes that help
  classify and organize content. Use chip to show product tags, categories, or
  metadata near the items they describe, helping users identify items with
  similar properties.
api_version: 2026-07
source_url:
  html: >-
    https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/web-components/typography-and-content/chip
  md: >-
    https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/web-components/typography-and-content/chip.md
api_name: customer-account-ui-extensions
---

# Chip

The chip component displays static labels, categories, or attributes that help classify and organize content. Use chip to show product tags, categories, or metadata near the items they describe, helping users identify items with similar properties.

Chips can include icons to provide additional visual context. For system-generated status indicators, use [badge](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/web-components/feedback-and-status-indicators/badge). For interactive or removable chips, use [clickable chip](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/web-components/actions/clickable-chip).

### Support Targets (24)

### Supported targets

* [customer-account.​footer.​render-after](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/footer#footer-render-after-)
* [customer-account.​order-index.​announcement.​render](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/order-actions#order-index-announcement-)
* [customer-account.​order-index.​block.​render](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/order-actions#order-index-block-)
* [customer-account.​order-status.​announcement.​render](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/order-status#order-status-announcement-)
* [customer-account.​order-status.​block.​render](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/order-status#order-status-block-)
* [customer-account.​order-status.​cart-line-item.​render-after](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/order-status#cart-line-item-render-after-)
* [customer-account.​order-status.​cart-line-list.​render-after](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/order-status#cart-line-list-render-after-)
* [customer-account.​order-status.​customer-information.​render-after](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/order-status#customer-information-render-after-)
* [customer-account.​order-status.​fulfillment-details.​render-after](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/fulfillment-status#fulfillment-status-targets)
* [customer-account.​order-status.​payment-details.​render-after](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/payments-and-returns#payments-and-returns-targets)
* [customer-account.​order-status.​return-details.​render-after](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/payments-and-returns#return-details-render-after-)
* [customer-account.​order-status.​unfulfilled-items.​render-after](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/fulfillment-status#unfulfilled-items-render-after-)
* [customer-account.​order.​action.​menu-item.​render](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/order-actions#order-action-menu-item-)
* [customer-account.​order.​action.​render](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/order-actions#order-action-)
* [customer-account.​order.​page.​render](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/full-page#order-specific-full-page-)
* [customer-account.​page.​render](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/full-page#customer-account-full-page-)
* [customer-account.​profile.​addresses.​render-after](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/profile-page-default#profile-page-default-targets-)
* [customer-account.​profile.​announcement.​render](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/profile-page-default#profile-announcement-)
* [customer-account.​profile.​block.​render](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/profile-page-default#profile-block-)
* [customer-account.​profile.​company-details.​render-after](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/profile-page-b2b#profile-page-b2b-targets-)
* [customer-account.​profile.​company-location-addresses.​render-after](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/profile-page-b2b#company-location-addresses-render-after-)
* [customer-account.​profile.​company-location-payment.​render-after](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/profile-page-b2b#company-location-payment-render-after-)
* [customer-account.​profile.​company-location-staff.​render-after](https://shopify.dev/docs/api/customer-account-ui-extensions/2026-07-rc/targets/profile-page-b2b#company-location-staff-render-after-)
* customer-account.​profile.​payment.​render-after

#### Use cases

* **Product tags**: Label items with attributes like "Organic," "Best Seller," or "Limited Edition" for quick scanning.
* **Status indicators**: Show category or attribute labels alongside order details or account content.
* **Active filters**: Display currently applied filters so customers can see and manage their selections.
* **Compact metadata**: Display compact attribute labels in lists or cards to help customers identify items with shared properties.

***

## Properties

Configure the following properties on the chip component.

* **accessibilityLabel**

  **string**

  A label that describes the purpose or contents of the chip. It will be read to users using assistive technologies such as screen readers.

* **id**

  **string**

  A unique identifier for the element. Use this to reference the element in JavaScript, link labels to form controls, or target specific elements for styling or scripting.

***

## Slots

The chip component supports slots for additional content placement within the component. Learn more about [using slots](https://shopify.dev/docs/api/polaris/using-polaris-web-components#slots).

* **graphic**

  **HTMLElement**

  An optional graphic displayed at the start of the chip, such as an icon to visually reinforce the chip's label. Only the `s-icon` element and its `type` attribute are supported.

***

## Examples

### Display a basic chip

Highlight a short piece of information with a styled tag. This example renders an `s-chip` containing a "50% OFF" promotional label.

## Display a basic chip

![A small rounded label element displaying categorization or status text.](https://shopify.dev/assets/assets/images/templated-apis-screenshots/checkout-ui-extensions/2025-10/chip-default-CqJC596o.png)

## html

```html
<s-chip accessibilityLabel="Promotional offer">50% OFF</s-chip>
```

### Pair an icon with a screen reader label

Add an icon when the chip text alone doesn't convey the full meaning. This example pairs the `graphic` slot with `s-icon` and sets `accessibilityLabel` for clearer context.

## html

```html
<s-chip accessibilityLabel="Carbon neutral shipping">
  <s-icon slot="graphic" type="check"></s-icon>
  Carbon neutral
</s-chip>
```

### Group product tags in an inline layout

Display multiple product attributes as a row of chips. This example uses `s-stack` with `direction="inline"` to arrange three `s-chip` elements side by side.

## html

```html
<s-stack direction="inline" gap="small">
  <s-chip>Organic</s-chip>
  <s-chip>Best Seller</s-chip>
  <s-chip>Limited Edition</s-chip>
</s-stack>
```

***

## Best practices

* **Keep labels concise**: Use one to three words per chip so the label remains scannable at a glance.
* **Pair icons with labels**: When adding an icon using the `graphic` slot, also set `accessibilityLabel` so screen readers convey the full meaning.
* **Avoid crowding the layout**: Limit chips to meaningful labels like status or category — too many chips make the page harder to scan.

***
