Polaris
The base Shopify Polaris components, each with a live, copy-paste example.
Actions
Button
The control merchants click to take an action, with primary, secondary, tertiary, plain and destructive variants plus icon, loading, disabled and size options.
Button group
Groups related buttons together so they read as one set of choices, either spaced, segmented into a single control, or loosely spaced.
Account connection
Shows whether a merchant has connected a third-party account to the app, and lets them connect or disconnect it in one click.
Page actions
The primary and secondary actions that close out a page, such as saving a discount or deleting it, placed at the bottom of the form.
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
Avatar
Shows a visual identifier for a person or business, falling back from an image to initials to a customer placeholder, in five sizes.
Icon
Renders a Polaris icon SVG at a consistent 20x20 size, with tones that colour it for success, critical, caution, info, magic and subdued states.
Thumbnail
A small square preview of a product image or file, in extra small through large sizes, used beside a line item in lists and orders.
Keyboard key
Renders a single key as a physical keycap, combined with InlineStack to document a keyboard shortcut such as Ctrl + S.
Video thumbnail
A clickable poster image with a play button and duration badge that launches a video, optionally showing how far the viewer has watched.
Feedback indicators
Badge
A small label that communicates the status of an object, such as an order's fulfillment or payment state, with tones, sizes and a progress pip.
Banner
A prominent message at the top of a page or card that informs merchants about a change, a problem or an action they need to take.
Exception list
A compact list of warnings and critical problems attached to an item, such as the risks or fulfillment issues on a single order.
Progress bar
A horizontal bar that shows how far along a long-running task is, with highlight, primary, success and critical tones in three sizes.
Spinner
An animated indicator that tells merchants a short, indeterminate wait is in progress, in a small inline size and a large page-level size.
Skeleton body text
Placeholder lines that stand in for paragraphs while a card's content loads, keeping the layout from jumping when the real text arrives.
Skeleton display text
A placeholder block that stands in for a heading or a headline metric while the page loads, in four sizes.
Skeleton page
A full-page loading shell with a placeholder title, back action and primary action, filled with skeleton cards until the real page is ready.
Skeleton tabs
Placeholder tabs that hold the shape of a card's tab strip while the real tabs and their content load.
Skeleton thumbnail
A square placeholder that reserves the space for a product image while it loads, in extra small through large sizes.
Typography
Tables
DataTable
Displays tabular data such as sales figures in rows and columns, with sortable headings and a totals row, for comparing numbers rather than acting on individual records.
IndexTable
Lists a collection of records such as orders in a table, with row selection and bulk actions, for browsing and acting on many resources at once.
Lists
ActionList
A vertical list of actions, grouped into sections with icons, that a merchant picks from inside a popover or menu.
DescriptionList
Pairs a set of terms with their descriptions, such as an order summary or a plan's details, so related facts read as one block.
List
Groups related items as a bulleted or numbered list, for short sets of facts, steps or requirements inside a page.
ResourceList
Shows a collection of records such as customers as scannable rows with media, selection, bulk actions and filtering, when each row needs more layout than a table cell allows.
Navigation
Link
A text link that takes someone to another page, either inside the app or out to an external site, and can be styled inline, monochrome or without an underline.
Pagination
Previous and next controls for stepping through a long list one page at a time, with an optional label describing the range currently on screen.
Tabs
A horizontal row of views over the same set of data, letting someone switch between related sections without leaving the page.
FooterHelp
A centered block at the bottom of a page that points merchants to the documentation for whatever they were just doing.
Overlays
Modal
An overlay that interrupts the page to ask for a decision or a short piece of input, and blocks everything else until it is dismissed.
Popover
A small overlay anchored to a button that holds secondary actions or settings, keeping them out of the way until they are needed.
Tooltip
A short floating hint shown on hover or focus, used to explain a control or a term without cluttering the page.