Skip to content

Checkbox Styling

Style every visual detail of Checkbox (Single) and Checkbox (Multi) — item style, the selection box and its glyph, labels, per-value help text, layout, disabled state, and the quantity stepper — using per-type templates.

Overview

Read Types Settings first if you haven't created a template before. In the Style Settings modal this type is labeled Checkboxes — one template collection styles both Checkbox (Single) and Checkbox (Multi) options.

The editor's left navigation has 9 tabs, in this order: Item Style, Selection Box (with 2 sub-sections — the box, then the glyph), Label, Help Text, Layout, Disabled State, Quantity Input, Behavior, Advanced — matching the sections below.

Item Style

The entry-point preset. Container fields only appear once Boxed is picked.

SettingOptions (default)What it controls
Item StylePlain (default) / BoxedPlain rows, or each value wrapped in a clickable card. The fields below appear only when Boxed

Item Container (Boxed only):

SettingOptions (default)What it controls
Paddingper side, max 32px (12/14/12/14)Space inside each card
Corner Radius0–20px (8px)Card roundness
Border Width0–3px (1px)Card border thickness
Background (Idle / Hover / Selected)color, transparent allowed (#FFFFFF each)Card fill per state
Border Color (Idle / Hover / Selected)color (#E2E8F0 each)Card border color per state

All three states share the same default

Idle, Hover, and Selected all start at the same color — set them apart to make hover and selection visible.

Selection Box

The box shape and its unselected/selected colors — shown as one nav item with two sub-sections.

The Box

SettingOptions (default)What it controls
Box Size14–32px (20px)Size of the checkbox box
Corner Radius0–16px (4px)Box roundness — capped at half the box size, so the top of the range is always a perfect circle
Border Width0–4px (2px)Box border thickness
Background (unselected)color, transparent allowed (#FFFFFF)Box fill when unchecked
Border Color (unselected)color (#CBD5E1)Box border when unchecked — hidden if Border Width is 0
Selected Accentcolor (#2563EB)Drives the whole selected state. What it colors depends on Fill Mode below

The Glyph

SettingOptions (default)What it controls
Fill ModeFilled (default) / InsetFilled = the accent fills the box, the glyph sits on top. Inset = the glyph takes the accent color, the box stays light
GlyphCheckmark (default) / Dash / Dot / SquareWhich mark is drawn when selected
Glyph Colorcolor (#FFFFFF)Mark color — Filled mode only; in Inset mode the glyph uses the Selected Accent
Glyph Size40–90% (65%)Mark size, as a percentage of the box
Glyph Thickness1–4 (2)Stroke weight — Checkmark and Dash only

Label

SettingOptions (default)What it controls
Font Size10–20px (14px)Value label size
Font WeightRegular (default) / Medium / Semibold / BoldValue label weight
Text Color (Idle / Hover / Selected)color (#1F2937 each)Label color per state

Hover and Selected default to Idle

Unset, Hover and Selected colors inherit whatever Idle is set to — set them individually to make hover/selection visible.

Help Text

Styles the optional per-value Help Text field. These settings only apply to values that actually have help text — a value without it reserves no space.

SettingOptions (default)What it controls
Display AsInline (default) / TooltipInline = a line under the label. Tooltip = a ⓘ icon with a hover bubble. Fields below switch with this

Inline mode:

SettingOptions (default)What it controls
Font Size8–16px (12px)Help text size
Text Color (Idle / Hover / Selected)color (#94A3B8 each)Help text color per state
Gap Below Label0–8px (2px)Space between the label and the help text

Tooltip mode:

SettingOptions (default)What it controls
Icon Colorcolor (#94A3B8)The ⓘ icon color
Tooltip PositionTop (default) / BottomWhere the bubble appears
Tooltip Background / Text Colorcolor (#1A1A1A / #FFFFFF)Bubble colors
Tooltip Font Size10–18px (13px)Bubble text size
Tooltip Max Width100–400px (260px)Bubble width before it wraps
Tooltip Padding / Corner Radiuspx (8/12/8/12 · 6px)Bubble inner spacing and roundness
Tooltip ShadowNone / Soft (default) / MediumBubble shadow

Layout

SettingOptions (default)What it controls
Box PositionLeft (default) / RightBox before or after the label
Gap to Label4–24px (10px)Space between the box and the label
Columns1 (default) / 2 / 3 / AutoHow many columns the value list uses
Spacing Between Options0–32px (8px)Vertical/grid gap between values

Disabled State

Applies to values the inventory check marks unavailable.

SettingOptions (default)What it controls
Hide Out-of-Stock Valuestoggle (off)Removes out-of-stock values from the list entirely instead of styling them — no reserved gap. If every value is out of stock, the whole option is hidden. Required options always stay visible: their values show as out of stock so the customer can see why they can't add to cart. The fields below only apply while this is off
Opacity20–100% (40%)How faded an unavailable value is. Floored at 20% — anything lower reads as an invisible hole in the list; use Hide instead if you want it gone
Strike Through Labeltoggle (off)Draws a line through an unavailable value's label
OverlayNone (default) / Diagonal / Cross / FadeExtra visual over an unavailable value
Overlay Colorcolor (#999999)Color of the Diagonal/Cross overlay — only for those two

No click-behavior setting

Out-of-stock values are always non-selectable — a variant that can't be bought can't be picked, so there's no toggle for it. Hide or style is the only choice.

Quantity Input

Only appears when a value is priced with a quantity box.

SettingOptions (default)What it controls
LayoutConnected (default) / Separated / Field onlyConnected = one pill (− n +). Separated = three detached boxes. Field only = just the number, no buttons
Height24–44px (28px)Stepper height
Number Width20–64px (24px)Width of the number box
Border Width0–3px (1px)Border thickness
Corner Radius0–20px (6px)Roundness
Show Dividerstoggle (on)Lines between −, number, and + — Connected layout only
Font Size / Weight10–18px (13px) · Regular–Bold (Medium)The number's typography
Text Color / Background / Border Colorcolor (#333333 / #FFFFFF / #CBD5E1)The number box colors
Button StyleGhost (default) / Solid−/+ buttons: transparent (Ghost) or filled (Solid). Buttons are hidden in Field-only
Button Colorcolor (#333333)The −/+ glyph color (idle)
Button Backgroundcolor (#F1F5F9)−/+ fill — Solid only
Button Color / Background (Hover)color (#333333 / #E2E8F0)−/+ colors on hover

Behavior

SettingOptions (default)What it controls
Select All Controltoggle (off)Adds a "Select all" control above the list that checks/unchecks every available value
Select All Labeltext ("Select all")The control's label — only shown when Select All Control is on

Advanced

SettingOptions (default)What it controls
Focus Ring Colorcolor (#3B82F6)Ring shown when a value is reached by keyboard — can't be turned off
Focus Ring Width1–4px (2px)Ring thickness

How to Style Checkbox

  1. Open the Style Settings modal (see Customization Overview)
  2. Click TypesCheckboxes
  3. Create a new template or click an existing one to edit it
  4. Use the left navigation to jump between Item Style, Selection Box, Label, Help Text, Layout, Disabled State, Quantity Input, Behavior, and Advanced
  5. Click Manage preview above the Live Preview to mock up test values — see Sandbox & Live Preview
  6. Click Save in the contextual save bar