Skip to content
Maison

Search the documentation

Type a setting, a section or a question.

Theme settings

Buttons and fields

One grammar for everything shoppers touch: height, shape, fields, options, and icons.

On this page

Everything shoppers interact with — buttons, fields, product options, the quantity selector — shares the same height, the same outline, and the same kind of label. Open Theme settingsButtons and fields to set this shared grammar.

SettingValuesWhat it does
Control sizeFR: Taille des contrôles
  • Compact
  • Standard
  • Large
Default: Standard
The height of every button, field, option and quantity selector.
Control shapeFR: Forme des contrôles
  • Square
  • Soft
  • Pill
Default: Pill
Applies to buttons, outlined fields, options and quantity selectors. Images, cards and panels keep square corners.
Field styleFR: Style des champs
  • Underline
  • Outline
Default: Underline
Every field in the theme follows this style.
Option styleFR: Style des options
  • Text
  • Boxes
  • Dropdown
Default: Text
How product options such as sizes are shown. Colours and variant pictures always show as swatches; long lists fall back to a dropdown.
Icon weightFR: Épaisseur des icônes
  • Thin
  • Regular
Default: Thin
—

Control size

SizeHeight
Compact44px
Standard48px
Large52px

Even at the compact size, no control is shorter than 44px on a touch screen.

Control shape

  • Square: square corners.
  • Soft: corners rounded by 6px.
  • Pill: fully rounded ends.

The shape applies to buttons, outlined fields, boxed options, and the quantity selector. Color swatches are round with the Pill shape and square otherwise. Images, cards, panels, and drawers always keep square corners.

Field style

  • Underline: only the bottom edge of the field is drawn.
  • Outline: the field has a full outline that follows the control shape.

Every field in the theme follows this setting: search, newsletter, contact, comments, order note, price filters, gift card recipient, quantity.

Option style

This setting controls how named product options, such as sizes, are displayed:

  • Text: values are written side by side; the selected value is underlined.
  • Boxes: each value sits in a box as tall as the controls; the selected value is outlined.
  • Dropdown: one dropdown menu per option.

Whatever this setting:

  • colors and patterns defined as swatches in Shopify always display as swatches (see Color swatches);
  • an option whose variants each have their own image displays as thumbnails of those images;
  • a list that's too long switches to a dropdown (the threshold is set in the Variant picker block, 12 values by default).

Buttons

There's no global button style: a button's style expresses what it commits the shopper to.

StyleForExample
SolidThe main action on a screenAdd to cart, Checkout
OutlinedA genuine alternativeBrowse the collection when a product is sold out
UnderlinedA next step with no commitmentView all, Read more

For a button you place yourself (the Button block, the link in the Image with text section), you choose the style. Solid button colors come from the accent and accent text of the section's color scheme.

Icon weight

Thin draws icons with a 1px stroke, Regular with a 1.5px stroke. Every icon in the theme (cart, search, account, menu, arrows, social media) follows this setting.

Was this page helpful?

Maison 1.0.0