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
| Setting | What it does |
|---|---|
| Light or dark | Pick the light or the dark version of this style. Choices: Light, Dark, Visitor's choice. |
| Palette | Ready-made color sets for your theme. Picking one fills all your colors at once. |
| Main | Buttons, links and key highlights across your store. |
| Accent | Sale tags, badges and small highlights. |
| Background | The color behind everything on your pages. |
| Text | The color of headings and paragraphs. |
Under More options the same group holds the rest of the color wells:
| Setting | What it does |
|---|---|
| Box color | The color of cards and boxes that sit on the background. |
| Faded text | The color of small notes, dates and less important words. |
| Lines | The color of borders and dividing lines. |
| Contrast band | The background of bold sections that stand out on a page. |
| Tint with brand | Gives 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).
Zone colors: header, footer and announcement bar
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):
| Setting | What it does |
|---|---|
| Header color | Standard, Bold, Light, or your own colors for the header. |
| Footer color | Standard, Bold, Light, or your own colors for the footer. |
| Bar color | Standard, Bold, Light, or your own colors for the announcement bar. |
When you pick your own colors the rail shows four wells for that zone:
| Setting | What it does |
|---|---|
| Background | The color behind this part of the store. |
| Text | The color of words in this part of the store. |
| Faded text | The color of small, quieter words in this part of the store. |
| Lines | The 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
| Setting | What it does |
|---|---|
| Pattern | What sits behind your pages. Plain means just your Background color. |
| Decorations | Small shapes and textures the style adds behind sections. |
| Paper texture | How strong the paper texture is. Shows on plain backgrounds, not photos. |
| Store look | Classic 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 CSS | For 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
- Open Storefront → Theme, or open any page in the editor and choose Settings → Theme.
- Open the Colors group. Pick Light or Dark if your theme offers both.
- Open Palettes and pick one, or set Main, Accent, Background and Text yourself.
- Check the readability line under Main. If it says the pair is hard to read, use the fix it offers.
- Open Look and choose a Pattern and, if you want, adjust Decorations.
- 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.
| Group | Control | Options | What it does |
|---|---|---|---|
| Themes | Theme: Playful Geometry | 1 of 6 themes | A complete preset — colours, fonts, corners and motion in one click. Picking it replaces your current look, and you can adjust anything afterwards. |
| Themes | Theme: Neo-Brutalism | 1 of 6 themes | A complete preset — colours, fonts, corners and motion in one click. Picking it replaces your current look, and you can adjust anything afterwards. |
| Themes | Theme: Botanical | 1 of 6 themes | A complete preset — colours, fonts, corners and motion in one click. Picking it replaces your current look, and you can adjust anything afterwards. |
| Themes | Theme: Sketch | 1 of 6 themes | A complete preset — colours, fonts, corners and motion in one click. Picking it replaces your current look, and you can adjust anything afterwards. |
| Themes | Theme: Neumorphism | 1 of 6 themes | A complete preset — colours, fonts, corners and motion in one click. Picking it replaces your current look, and you can adjust anything afterwards. |
| Themes | Theme: Corporate Trust | 1 of 6 themes | A complete preset — colours, fonts, corners and motion in one click. Picking it replaces your current look, and you can adjust anything afterwards. |
| Themes | Apply theme button | action (commit selected theme LIVE) | Commits the theme you have previewed. Nothing changes for buyers until you apply. |
| Themes | Reset theme button | action (clear creator color/font customisations) | Returns everything to the theme default, discarding your customisations. |
| Palette | Palettes 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. |
| Palette | My Palettes group | creator's saved palettes (theme_variants, tenant-scoped) | Palettes you have saved yourself. |
| Palette | Save as custom palette button | action (create theme_variant) | Keeps the colours you've landed on as a named set, so you can return to it after experimenting. |
| Colors | Primary color well | hex color | Your 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. |
| Colors | Accent color well | hex color | A second colour for highlights and badges. Used sparingly; if it competes with the primary, nothing reads as the main action. |
| Colors | Background color well | hex color | The 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. |
| Colors | Surface color well | hex color | Cards, panels and anything raised off the page background. A slight difference from the background is what makes a card read as a card. |
| Colors | Text color well | hex color | The colour of body copy. Contrast against the background is what makes a store readable on a phone in daylight. |
| Colors | Text Muted color well | hex color | Secondary text — captions, timestamps, helper lines. Quieter than body copy but still legible. |
| Colors | Border color well | hex color | The lines around cards, inputs and dividers. Lower contrast reads calmer; higher contrast reads more structured. |
| Colors | Section Bold color well | hex color | The background for sections you want to stand out from the rest of the page. |
| Background | Background slot 1 | slot 1/2/3 | A background layer — a colour, gradient or image. Layers stack, so a later slot sits over an earlier one. |
| Background | Background slot 2 | slot 1/2/3 | A background layer — a colour, gradient or image. Layers stack, so a later slot sits over an earlier one. |
| Background | Background slot 3 | slot 1/2/3 | A background layer — a colour, gradient or image. Layers stack, so a later slot sits over an earlier one. |
| Background | Background custom: None | 8 pattern types | A plain background — just the colour. The safest choice when your products are the visual interest. |
| Background | Background custom: Solid | 8 pattern types | A single flat colour. |
| Background | Background custom: Dot Grid | 8 pattern types | A faint grid of dots. Adds texture without competing with content. |
| Background | Background custom: Halftone | 8 pattern types | A printed-dot pattern. Distinctive, and heavy — best behind a single hero section rather than a whole page. |
| Background | Background custom: Paper Grain | 8 pattern types | A subtle paper texture — warms up an otherwise flat page. |
| Background | Background custom: Ambient Orbs | 8 pattern types | Soft coloured glows behind the content. Reads modern and can wash out text if the contrast drops. |
| Background | Background custom: Grid Paper | 8 pattern types | Faint ruled lines, like graph paper. |
| Background | Background custom: Animated | 8 pattern types | A moving background. Costs performance on older phones and pulls the eye away from your products. |
| Button | Button shape | rounded (6px) / sharp (0px) / pill (999px) | Square, rounded or pill. Pills read consumer and friendly; squares read technical. |
| Button | Hover effect | darken / lift / scale / wiggle / fill-accent | What 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. |
| Button | Shadow | none / soft / soft-diffused / soft-hard / hard-offset | How much a button lifts off the page. |
| Button | Text style (text-transform) | none / uppercase / capitalize | Whether text renders as typed, uppercase, or title case. |
| Card | Card style | shadow / border / flat | Whether cards have a border, a shadow, or neither. Borderless cards need a background difference to read as separate. |
| Card | Card shadow | none / soft / soft-diffused / soft-hard / hard-offset | How much cards lift off the page. |
| Card | Hover effect | none / lift / wiggle / rotate | What 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. |
| Card | Product image shape (store-wide) | theme / rounded / square / circle / dome | Square, portrait or landscape crops for every product image. Consistency matters more than the choice — mixed shapes make a grid look untidy. |
| Decorations Enabled (master) | Switch | One switch for all decorative flourishes. Off is a valid choice — decoration should earn its place. | |
| Harmonize neutrals from brand | Switch | Tints greys toward your brand colour so the neutrals look chosen rather than default. | |
| Paper Grain Opacity | Slider 0–1, step 0.05, default 0.20 | How strong the paper texture is. Past about a third it starts to fight your text for attention. | |
| Reset Decoration Overrides | Button (action) | Clears decoration changes without touching the rest of the theme. | |
| [removed/moved] | n/a | No 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.