Understand Scale Theme's color palette system and learn to create visual contrast between your sections.
Color Palettes
Scale Theme uses Shopify's native Color Schemes system. Each section chooses a palette, and all of the section's colors (text, background, buttons, accents) adapt automatically.
How It Works
The Principle
Each palette defines a coherent set of 6 colors + 1 optional gradient. When you assign a palette to a section, it inherits all colors without additional configuration.
"Light" Palette "Dark" Palette
┌─────────────────────┐ ┌─────────────────────┐
│ Background: #FFFFFF │ │ Background: #1A1A1A │
│ Background 2: #F5F5F5│ │ Background 2: #2D2D2D│
│ Text: #121212 │ │ Text: #F5F5F5 │
│ Text 2: #666666 │ │ Text 2: #AAAAAA │
│ Accent 1: #E63946 │ │ Accent 1: #FF6B6B │
│ Accent 2: #457B9D │ │ Accent 2: #64DFDF │
└─────────────────────┘ └─────────────────────┘The 6 Colors in a Palette
| Color | Role | Typical Usage |
|---|---|---|
| Text | Primary text | Headings, paragraphs, labels |
| Text secondary | Secondary text | Descriptions, metadata, lighter text |
| Background | Primary background | Section background color |
| Background secondary | Alternate background | Cards, highlights, secondary areas |
| Accent 1 | Primary accent | Main buttons, links, active elements |
| Accent 2 | Secondary accent | Secondary buttons, badges, complementary elements |
Each palette also supports an optional background gradient that replaces the solid background.
Generated CSS Variables
For each palette, Scale Theme automatically generates CSS variables and derived variants:
| Variable | Format | Description |
|---|---|---|
--color-background | r,g,b | Primary background |
--color-background-secondary | r,g,b | Secondary background |
--color-background-dark | r,g,b | Darkened background (-8% brightness) |
--color-foreground | r,g,b | Primary text |
--color-foreground-secondary | r,g,b | Secondary text |
--color-foreground-dark | r,g,b | Darkened text |
--color-accent-1 | r,g,b | Primary accent |
--color-accent-1-dark | r,g,b | Darkened primary accent |
--color-accent-2 | r,g,b | Secondary accent |
--color-accent-2-dark | r,g,b | Darkened secondary accent |
--gradient-background | gradient | Optional gradient |
r,g,b format (without rgb()). You must always use them with rgb() or rgba() in CSS: ``css /* Correct */ background: rgb(var(--color-background)); color: rgba(var(--color-foreground), 0.5); /* Incorrect */ background: var(--color-background); ``Usage in Sections
Every Scale Theme section has a Color palette setting in the editor. Select the desired palette and the section automatically inherits all colors.
In the code, the palette is applied via the CSS class:
<div class="color-{{ section.settings.color_palette }}">
<!-- All content inherits the colors -->
</div>Creating Visual Rhythm
The power of the palette system lies in alternating between sections. By varying palettes, you create visual rhythm that guides the eye and maintains attention.
Recommended Alternation Strategy
| Section | Suggested Palette | Effect |
|---|---|---|
| Banner (Hero) | Dark or Accent | Strong impact, first impression |
| Featured Collection | Light | Breathing room, focus on products |
| Rich text / Testimonials | Dark | Contrast, visual separation |
| Product grid | Light | Readability, catalog focus |
| CTA / Newsletter | Accent | Draws attention, encourages action |
| Footer | Dark | Closes the page |
Creating Effective Palettes
Light palette (main scheme)
- Background: White or very light (#FFFFFF, #FAFAFA)
- Text: Dark (#121212, #1A1A1A)
- Accent 1: Vivid brand color
- High contrast, ideal for main content
Dark palette (emphasis)
- Background: Dark (#1A1A1A, #111111)
- Text: Light (#F5F5F5, #EEEEEE)
- Accent 1: Same accent as the light palette (or a more vivid version)
- Creates strong contrast with light sections
Accent palette (CTAs, promos)
- Background: Your accent color
- Text: White (#FFFFFF)
- Accent 1: White or contrasting color
- Draws attention, ideal for calls to action
Secondary palette (subtle variation)
- Background: Very light gray (#F5F5F5, #F0F0F0)
- Text: Same as the light palette
- Accent: Same as the light palette
- Subtle difference, ideal for alternating without a strong break
Automatic Variants
The -dark variants are automatically calculated by Scale Theme (-8% brightness). They are used for:
- Hover states of buttons and links
- Subtle borders
- Shadows and depth
- Active states of interactive elements
You don't need to configure these variants manually. The css-variables.liquid system generates them from your base colors.