Skip to main content

Style controls

In short: The Style controls in the theme: the theme in use, Light or dark, Colors, Pattern, Decorations, Paper texture, Store look and Custom CSS.

Style is the overall look of your store: which theme it wears, its colors, the pattern behind your pages, and the small decorations on top. Everything here is store-wide. Change a color once and every page follows.

  • You reach these controls in two places: Storefront → Theme, or Settings → Theme in the page editor header (the same screen, see The Theme screen).
  • The left side of the Theme screen is split into six groups: Look, Colors, Fonts, Buttons & photos, Store frame and This page.
  • This page covers the style parts of Look and all of Colors.
  • Corners, spacing and motion are on Layout and motion controls; fonts are on Typography controls.

Where to find it​

Sidebar → STOREFRONT → Theme, or open any page in the editor and choose Settings → Theme. Open the Look or Colors group.

The theme in use​

At the top of the rail, above the groups, a Style row names the theme your store uses and says: "The overall look. Colors and fonts change; your words and products don't."

  • Change store theme opens the Theme screen so you can pick a different theme for your whole store. You can see it on your own pages first.
  • Reset puts all color and font overrides back to the theme's own defaults. The editor asks "Reset (theme name) to its original colors and fonts? Your customizations will be lost." before it does.

PersonaCart ships six themes: Playful Geometry, Neo-Brutalism, Botanical, Sketch, Neumorphism and Corporate Trust. Themes that come in both versions offer Light and Dark; each theme also has ready-made palettes and its own pattern and decoration choices.

Colors group​

SettingWhat it does
Light or darkPick the light or the dark version of this style. Choices: Light, Dark, Visitor's choice.
PaletteReady-made color sets for your theme. Picking one fills all your colors at once.
MainButtons, links and key highlights across your store.
AccentSale tags, badges and small highlights.
BackgroundThe color behind everything on your pages.
TextThe color of headings and paragraphs.

Under More options the same group holds the rest of the color wells:

SettingWhat it does
Box colorThe color of cards and boxes that sit on the background.
Faded textThe color of small notes, dates and less important words.
LinesThe color of borders and dividing lines.
Contrast bandThe background of bold sections that stand out on a page.
Tint with brandGives backgrounds and boxes a light wash of your Main color.

Good to know about colors​

  • Palettes opens a gallery of ready-made color sets for your theme.
    • Picking one fills all your colors at once.
    • You can Save as Custom Palette (up to 16 characters for the name, "My Palette" is suggested) so you can come back to it, and Reset to variant defaults returns to the theme's own colors.
  • Each color well takes a swatch pick or a typed hex value.
  • Under Main the editor measures how readable it is on your Background. If it is too low it shows, for example, "#aaa on #fff: 1.4:1, too low to read" and offers a fix that "Moves your Main color just enough to be readable on your Background."
  • Light or dark only appears for themes that have both versions. To let buyers switch your store to dark mode themselves, turn on Light/dark switch in the header (Store frame).

The header, the footer and the announcement bar each have their own color setting so they can stand out from the page. Each offers Standard, Bold, Soft (or Light), or Custom (your own colors):

SettingWhat it does
Header colorStandard, Bold, Light, or your own colors for the header.
Footer colorStandard, Bold, Light, or your own colors for the footer.
Bar colorStandard, Bold, Light, or your own colors for the announcement bar.

When you pick your own colors the rail shows four wells for that zone:

SettingWhat it does
BackgroundThe color behind this part of the store.
TextThe color of words in this part of the store.
Faded textThe color of small, quieter words in this part of the store.
LinesThe color of thin dividing lines in this part of the store.

On the home page, a header set to See-through has no color of its own while your first photo runs underneath it ("The header is see-through over the first section, so it has no color of its own.").

Look group: style controls​

SettingWhat it does
PatternWhat sits behind your pages. Plain means just your Background color.
DecorationsSmall shapes and textures the style adds behind sections.
Paper textureHow strong the paper texture is. Shows on plain backgrounds, not photos.
Store lookClassic is your store's current look. New is the newer look for your theme. Preview it, use it, or go back at any time.
Custom CSSFor developers. Code here can change your whole store’s look.

Pattern​

  • Pattern is a tile grid.
  • Each theme has its own patterns; Plain means "Just your page color".
  • Tap a tile to apply it, the preview shows the pattern over the theme's paper color.
  • Picking a pattern also turns Decorations back on.
  • There is a Custom tile where you pick a pattern type and your theme's colors fill in.

Decorations and Paper texture​

  • Decorations is the master switch for paper grain, halftone dots, ambient orbs and pattern overlays. Reset to default returns them to what the theme ships with.
  • Paper texture sets how strong the grain is, from 0 (invisible) to 1 (full). It shows on plain backgrounds, not on photos.
  • Tint with brand (under Colors, More options) gives the page background, boxes and bold sections a light wash of your Main color so the store feels custom-made.

Store look: Classic or New​

  • Stores that can switch see a Store look card.
  • Classic is the design your store has today.
  • New is the newer look for your theme: refined buttons, cards, images and footer, plus the Animation level.
  • You can preview it first ("Previewing the New design. This is only on this screen: your live store has not changed."), and nothing changes until you press Save.
  • Choosing New asks you to confirm: "Your whole shop will look different, including pages you already published. Your products, text and photos stay the same. You can go back for 30 days." Go back to Classic (within 30 days) undoes it.

Custom CSS​

Custom CSS is for developers: "Code here can change your whole store's look." It is injected into your storefront in a style tag, and the editor warns "Custom CSS may override theme settings."

Steps​

  1. Open Storefront → Theme, or open any page in the editor and choose Settings → Theme.
  2. Open the Colors group. Pick Light or Dark if your theme offers both.
  3. Open Palettes and pick one, or set Main, Accent, Background and Text yourself.
  4. Check the readability line under Main. If it says the pair is hard to read, use the fix it offers.
  5. Open Look and choose a Pattern and, if you want, adjust Decorations.
  6. Press Save (or Publish Theme) when you are happy. See Publishing.

What happens, and what doesn't​

  • Style controls are store-wide: every page follows, including pages you made earlier.
  • A single block can still override its own colors in the inspector; the inspector marks those as Changed here and offers Reset to theme. See The right rail.
  • Changing a color never changes your words, photos or products.
  • Imported (HTML) sections follow your theme only if Follow my theme is on for them.

Questions​

What is the difference between Main and Accent?

Main is for buttons, links and key highlights across your store. Accent is for sale tags, badges and small highlights.

Why does the editor say my Main color is too low to read?

It measures your Main color against your Background. If the contrast is too low, text on buttons can be hard to read; the fix moves Main just enough to make it readable.

Can I go back to a theme's original colors?

Yes. Reset puts all color and font overrides back to the theme's defaults, and Reset to variant defaults in the Palettes gallery does the same for colors.

Does Custom CSS affect every page?

Yes, the Custom CSS in the Look group applies to the whole store. For one page only, use Custom CSS in that page's settings.

Complete control matrix​

This is the full matrix of theme controls with the setting names the system stores. The tables above use the labels you see in the editor; this list is for completeness.

GroupControlOptionsWhat it does
ThemesTheme: Playful Geometry1 of 6 themesA complete preset — colours, fonts, corners and motion in one click. Picking it replaces your current look, and you can adjust anything afterwards.
ThemesTheme: Neo-Brutalism1 of 6 themesA complete preset — colours, fonts, corners and motion in one click. Picking it replaces your current look, and you can adjust anything afterwards.
ThemesTheme: Botanical1 of 6 themesA complete preset — colours, fonts, corners and motion in one click. Picking it replaces your current look, and you can adjust anything afterwards.
ThemesTheme: Sketch1 of 6 themesA complete preset — colours, fonts, corners and motion in one click. Picking it replaces your current look, and you can adjust anything afterwards.
ThemesTheme: Neumorphism1 of 6 themesA complete preset — colours, fonts, corners and motion in one click. Picking it replaces your current look, and you can adjust anything afterwards.
ThemesTheme: Corporate Trust1 of 6 themesA complete preset — colours, fonts, corners and motion in one click. Picking it replaces your current look, and you can adjust anything afterwards.
ThemesApply theme buttonaction (commit selected theme LIVE)Commits the theme you have previewed. Nothing changes for buyers until you apply.
ThemesReset theme buttonaction (clear creator color/font customisations)Returns everything to the theme default, discarding your customisations.
PalettePalettes browser~126 curated palettes (fetchAllPalettes, dynamic count)Ready-made colour sets. Picking one rewrites your primary, accent and background together, so the store stays coherent instead of becoming three unrelated choices.
PaletteMy Palettes groupcreator's saved palettes (theme_variants, tenant-scoped)Palettes you have saved yourself.
PaletteSave as custom palette buttonaction (create theme_variant)Keeps the colours you've landed on as a named set, so you can return to it after experimenting.
ColorsPrimary color wellhex colorYour main brand colour. It drives buttons, links and anything the store wants you to click — so it needs to stand out against your background, not blend into it.
ColorsAccent color wellhex colorA second colour for highlights and badges. Used sparingly; if it competes with the primary, nothing reads as the main action.
ColorsBackground color wellhex colorThe page behind everything. Small shifts here matter more than they look — a warm off-white and a cool grey give the same store two different characters.
ColorsSurface color wellhex colorCards, panels and anything raised off the page background. A slight difference from the background is what makes a card read as a card.
ColorsText color wellhex colorThe colour of body copy. Contrast against the background is what makes a store readable on a phone in daylight.
ColorsText Muted color wellhex colorSecondary text — captions, timestamps, helper lines. Quieter than body copy but still legible.
ColorsBorder color wellhex colorThe lines around cards, inputs and dividers. Lower contrast reads calmer; higher contrast reads more structured.
ColorsSection Bold color wellhex colorThe background for sections you want to stand out from the rest of the page.
BackgroundBackground slot 1slot 1/2/3A background layer — a colour, gradient or image. Layers stack, so a later slot sits over an earlier one.
BackgroundBackground slot 2slot 1/2/3A background layer — a colour, gradient or image. Layers stack, so a later slot sits over an earlier one.
BackgroundBackground slot 3slot 1/2/3A background layer — a colour, gradient or image. Layers stack, so a later slot sits over an earlier one.
BackgroundBackground custom: None8 pattern typesA plain background — just the colour. The safest choice when your products are the visual interest.
BackgroundBackground custom: Solid8 pattern typesA single flat colour.
BackgroundBackground custom: Dot Grid8 pattern typesA faint grid of dots. Adds texture without competing with content.
BackgroundBackground custom: Halftone8 pattern typesA printed-dot pattern. Distinctive, and heavy — best behind a single hero section rather than a whole page.
BackgroundBackground custom: Paper Grain8 pattern typesA subtle paper texture — warms up an otherwise flat page.
BackgroundBackground custom: Ambient Orbs8 pattern typesSoft coloured glows behind the content. Reads modern and can wash out text if the contrast drops.
BackgroundBackground custom: Grid Paper8 pattern typesFaint ruled lines, like graph paper.
BackgroundBackground custom: Animated8 pattern typesA moving background. Costs performance on older phones and pulls the eye away from your products.
ButtonButton shaperounded (6px) / sharp (0px) / pill (999px)Square, rounded or pill. Pills read consumer and friendly; squares read technical.
ButtonHover effectdarken / lift / scale / wiggle / fill-accentWhat a button or card does when the pointer is over it. On a phone nobody sees this — keep the resting state readable on its own.
ButtonShadownone / soft / soft-diffused / soft-hard / hard-offsetHow much a button lifts off the page.
ButtonText style (text-transform)none / uppercase / capitalizeWhether text renders as typed, uppercase, or title case.
CardCard styleshadow / border / flatWhether cards have a border, a shadow, or neither. Borderless cards need a background difference to read as separate.
CardCard shadownone / soft / soft-diffused / soft-hard / hard-offsetHow much cards lift off the page.
CardHover effectnone / lift / wiggle / rotateWhat a button or card does when the pointer is over it. On a phone nobody sees this — keep the resting state readable on its own.
CardProduct image shape (store-wide)theme / rounded / square / circle / domeSquare, portrait or landscape crops for every product image. Consistency matters more than the choice — mixed shapes make a grid look untidy.
Decorations Enabled (master)SwitchOne switch for all decorative flourishes. Off is a valid choice — decoration should earn its place.
Harmonize neutrals from brandSwitchTints greys toward your brand colour so the neutrals look chosen rather than default.
Paper Grain OpacitySlider 0–1, step 0.05, default 0.20How strong the paper texture is. Past about a third it starts to fight your text for attention.
Reset Decoration OverridesButton (action)Clears decoration changes without touching the rest of the theme.
[removed/moved]n/aNo longer in the editor — kept here only so an old screenshot or link still resolves.

43 controls in this group. Generated from the live theme-control matrix.