Skip to content

Appearance

Appearance settings

Appearance settings match add-on fields on your product pages to your store’s brand: colors, type scale, and spacing. One settings page, applied store-wide.

Store-wide, not per product. Appearance is a single global setting. There is no per-product or per-group override — a change here restyles every add-on field and panel on every product page.

Where to find Appearance settings

Go to Smart Add-Ons → Appearance in wp-admin. Any user who can manage WooCommerce can open it. The page has a live preview panel that updates as you change settings; click Save appearance to apply them on the storefront, or Reset to defaults to restore the built-in values below.

Brand colors

Eight hex color pickers, across two sections. Accent colors are used for selected options, prices, and focus states; the two background colors set the panel and field surfaces.

SettingDefaultUsed for
Accent#00a3a3Primary highlight: selected options, prices, and focus.
Accent hover#008585Hover and pressed state of the accent color.
Selected background#effafbSoft fill behind a selected option.
Text#0f172aPrimary field and panel text.
Muted text#64748bSecondary labels, help text, and captions.
Borders#e2e8f0Field, group, and panel borders.
Panel background#fafbfcBackground of the add-on panel itself.
Field background#ffffffBackground of individual fields inside the panel.

Typography

Type scale, label weight, and an optional font family. Leave font family empty to inherit the theme’s font.

SettingOptions
Type scaleCompact, Default, or Comfortable — a preset bundle of seven font sizes (eyebrow, title, heading, label, body, caption, price).
Label weightMedium (500), Semibold (600, default), or Bold (700).
Font familyOptional free-text CSS font-family, for example "Inter", system-ui, sans-serif. Empty inherits the theme.

Type scale sizes

RoleCompactDefaultComfortable
Eyebrow0.6875rem0.75rem0.8125rem
Title1rem1.125rem1.25rem
Heading0.875rem0.9375rem1.0625rem
Label0.75rem0.8125rem0.875rem
Body0.8125rem0.875rem1rem
Caption0.6875rem0.75rem0.8125rem
Price0.75rem0.8125rem0.875rem

Layout

Spacing density and an optional maximum width for the add-on panel on product pages.

SettingOptions
DensityCompact, Default, or Comfortable — a preset bundle of five spacing values (field, group, and panel spacing, textarea min-height, and control height).
Max panel widthOptional free-text CSS length, for example 42rem, 640px, or 100%. Empty defaults to 100%.

Density spacing

TokenCompactDefaultComfortable
Field spacing0.5rem0.625rem0.75rem
Group spacing0.75rem1rem1.25rem
Panel spacing0.75rem0.875rem1rem
Textarea min-height4.5rem5.5rem6.5rem
Control height2.25rem2.5rem2.75rem

How it is applied

Saved settings compile into CSS custom properties scoped to .saue-addon-wrapper, the wrapper around every add-on field and panel on the storefront. Because that class is on every product that shows add-ons, the same tokens apply store-wide.

To override a token from a child theme or custom CSS plugin, target that wrapper with a standard CSS custom property (opens in new tab) — there is no custom-CSS field on the Appearance settings screen itself.

theme.css
.saue-addon-wrapper {
  --saue-accent: #1d4ed8;
  --saue-accent-dark: #1e40af;
}

CSS custom properties

PropertySource
--saue-accentAccent
--saue-accent-darkAccent hover
--saue-accent-softSelected background
--saue-textText
--saue-text-mutedMuted text
--saue-borderBorders
--saue-surfacePanel background
--saue-surface-elevatedField background
--saue-font-familyFont family, or inherit
--saue-font-size-*Type scale (eyebrow, title, heading, label, body, caption, price)
--saue-font-weight-labelLabel weight
--saue-space-field, --saue-space-group, --saue-space-panelDensity spacing
--saue-control-height, --saue-textarea-min-heightDensity control sizes
--saue-panel-max-widthMax panel width, or 100%

The same settings are readable and writable over REST at GET / PUT /saue/v1/appearance (admin-only, manage_woocommerce). See the REST API reference.