PPolaris ComponentsConnect an agent

Polaris

The base Shopify Polaris components, each with a live, copy-paste example.

Actions

Layout and structure

Page

The outermost shell of a Shopify admin screen: it renders the title, subtitle, back action, primary action and the secondary action menu above your content.

Layout

Arranges the sections of a page: a full-width section, a two-column split with a one-third sidebar, and annotated settings sections with a title and description beside the fields.

Card

A rounded surface that groups related content, with optional heading actions, a secondary background and adjustable padding.

Box

The lowest-level layout primitive: a div that only speaks Polaris tokens for padding, background, border, radius and shadow.

BlockStack

Stacks its children vertically with a consistent token-based gap, plus control over horizontal alignment and vertical distribution.

InlineStack

Lays its children out in a row with a token-based gap, and controls how they are distributed horizontally, aligned vertically, and whether they wrap.

InlineGrid

A simple CSS grid for equal or proportional columns, with a responsive column count and token-based gaps.

Grid

A 12-column responsive grid where each Grid.Cell declares how many columns it spans at every breakpoint.

Bleed

Cancels out the padding of its parent with negative margins, so a banner, image or divider can run edge to edge inside a Card.

Divider

A horizontal rule that separates groups of content, with a choice of border color and thickness tokens.

FormLayout

Stacks form fields with the correct spacing, and groups related fields side by side with FormLayout.Group.

CalloutCard

A card with an illustration that promotes one clear next step, such as finishing setup or upgrading a plan.

MediaCard

A card that pairs an image or video with a title, description and actions — used for tutorials, announcements and featured content.

EmptyState

Fills a page or card that has no data yet with an illustration, an explanation and the action that creates the first record.

Selection and input

TextField

A single or multi-line text input for collecting typed data, with support for labels, help text, validation errors, prefixes, suffixes and connected actions.

Select

A dropdown that lets someone pick one option from a short, predefined list, with support for grouped options, help text, placeholders and errors.

Checkbox

A box someone can tick to turn a single option on or off, supporting help text, an indeterminate mixed state, errors and a disabled state.

RadioButton

A single button in a group where exactly one option can be selected at a time; use it when you need full control over the layout of each choice.

ChoiceList

A titled list of choices rendered as radio buttons, or as checkboxes with allowMultiple, with per-choice help text and nested fields.

RangeSlider

A draggable track for picking a number, or a low-and-high pair, inside a known range where the exact value matters less than the relative one.

Autocomplete

A text field that filters a list of options as the merchant types and lets them pick one or several, used for tagging, vendor pickers and other long known-value lists.

Combobox

An accessible text input paired with a Listbox popover, used to build custom autocomplete experiences such as a multi-select collection picker with tags.

Date picker

A month-by-month calendar for choosing a single date or a date range, used for scheduling discounts, filtering orders and picking report periods.

Drop zone

An upload area that accepts files by drag-and-drop or from the file browser, with a DropZone.FileUpload call to action and a list of the files that were accepted.

Filters

A search field plus a set of filter controls and removable applied-filter chips, used above a list or table so merchants can narrow down orders, products or customers.

Form

A wrapper that turns a group of fields into a real HTML form, so Enter submits it and onSubmit runs your handler instead of reloading the page.

InlineError

A field-level error message with a warning icon, used to explain a validation problem next to a control that has no built-in error prop.

Tag

A small label for a category or filter applied to an item, optionally removable with an X or clickable to drill into it.

Color picker

A hue, saturation and brightness surface with optional alpha slider for choosing a custom color, such as a storefront brand or badge color.

Option list

A grouped list of selectable options with single or multiple selection, used inside popovers and side panels for things like sales channels and locations.

Listbox

A keyboard-navigable list of selectable options with optional headers and actions, the building block behind Combobox and other custom pickers.

Images and icons

Feedback indicators

Typography

Tables

Lists

Navigation

Overlays

Utilities