Generally, an alert displays a prominent message at the top of the screen. It could be used to promote a new feature or provide action-based feedback messages. Theyâ€™re persistent and nonmodal, allowing the user to either ignore them or interact with them at any time.

Alert

Avatars are used to show a thumbnail representation of an individual or business in the interface.

Avatar

The Badge component is a visual indicator for numeric values such as tallies and scores.

Badge

Buttons are used to initialize an action. Button labels express what action will occur when the user interacts with it.

Button

The Calendar component is used for displaying data in calendar form, suitable for scenarios involving dates such as schedules, timetables, price calendars, and lunar calendars.

Calendar

Cards are used to group information about subjects and their related actions. Cards can include images, text, buttons, links, and data visualizations.

Card

Checkbox are used when there are multiple items to select in a list. Users can select zero, one, or any number of items.

Checkbox

The color picker allows for multiple methods of selecting a color. It could be navigating through colors on a color spectrum, or specifying a color in either Red-Green-Blue (RGB); or alpha color code; or Hexadecimal text inputs.

Color Picker

Similar to the Select (Dropdown) but allowing the user to edit the input field in order to sort through the list of options.

Combobox

A Date Picker is a text input to capture a date. You can select a single date, date range or date and time.

Date Picker

Useful for displaying a visual separator between parts of content. Used to divide sections of an article or to divide inline text and links, such as the operation column of a table.

Divider

This component is used for presenting various empty states, such as no items, empty search, broken link, welcome screen, etc. They are most commonly seen the first time a user interacts with a product or page, but can be used when data has been deleted or is unavailable. An empty state is an opportunity to engage and delight users adding an actionable button.

Empty State

The File Uploader allows a user to transfer a file or submit content of their own.

File Uploader

Links are used as navigational elements. They may appear on their own, within a sentence or paragraph, or directly following the content.

Link

This component presents a list of options that take immediate action or navigate the user outside of the current context. It can be thought of as a collection of links or buttons.

Pagination

The Popover component displays floating informative and actionable content in relation to a target. Popovers appear either at the top, bottom, left, or right of their target.

Popover

A Progress Bar is a linear indicator for providing feedback about an ongoing, user-initiated process.

Progress Bar

Use Radio to select a single option from a list. Radio should be used instead of checkboxes if only one item can be selected from a list.

Radio

Search enables users to specify a word or a phrase to find relevant pieces of content or filter a long list of elements. Commonly represented as a Text Input with a little magnifying glass inside of it.

Search

This component could be thought of as a styled native select tag, but adding to it more functionalities such as filtering, multi selecting, among others. The source of the Select (Dropdown) is a list of options that the user can choose from and apply to an input field to later be submitted.

Select

Skeleton provides a low fidelity representation of the user interface to visually communicate that content is in the process of loading. Some studies indicate that Skeletons can reduce the user's perceived loading time.

Skeleton

Sliders provide a visual indication of adjustable content, where the user can increase or decrease the value by moving the handle along a horizontal track.

Slider

A Spinner is an outline of a circle which animates around itself indicating to the user that things are processing. Use a Spinner when the content to be loaded is unknown or unpredictable.

Spinner

Table is a container for displaying data efficiently. Usually, it allows users to sort, search, paginate, filter data, and take action on large amounts of data.

Table

A text input is a field that allows a user to write or edit text.

Text Input

A multi-line text input component, used for longer texts in form fields. A Textarea lets users enter long form text which spans over multiple lines.

Textarea

Toasts are shown as a floating box typically in the top right of the page. They can optionally be displayed on other edges of the screen (top-left, bottom-left, etc). Toasts provide limited space for content, and therefore the content must be short and concise, providing immediate feedback in response to a user action or informing users of a process that the app has performed or will perform.

Toast

A tooltip is a floating, non-actionable label used to explain a user interface element or feature.

Tooltip

Our components are a collection of interface elements that can be reused across the Shopify system.

Polaris