ThemeTheme Settings

Theme settings

These are the store-wide controls — colors, fonts, spacing, and the TCG-specific features like playset sizes and the holo effect. Set them once and they apply across every page, unlike section settings, which only affect the one section you’re editing.

Where to find them. In the theme editor (Online Store → Edit theme), click the gear icon at the bottom of the left sidebar. Each group below is one collapsible panel there. Changes preview live and only go public when you click Save.

How colors work

Colors are set in pairs — a background and a matching foreground (text) color that are designed to be legible together. “Base” is your main page. “Secondary” is for panels and cards that need to stand off the page. “Accent” and “Button” drive links and calls-to-action. “Status” colors (error, warning, success) and “Muted” round out the set.

Because everything is a pair, sections and cards pull whichever pairing fits, so text stays readable whether you run a light store or a dark one. Change a base color and it ripples everywhere that pairing is used — you don’t restyle sections one by one.

Settings that connect to the app

A few groups here point at your Sideboard app rather than living entirely in the theme:

  • Collection filters — the theme picks the filter source (Sideboard, Search & Discovery, or off); the filters themselves are configured in whichever app you choose, and individual collection templates can override the source. The full story is Collection filters.
  • Buylist — sets where the “Sell Us This Card” button sends shoppers. Your buylist slug is the handle after /b/ in your Sideboard buylist URL.
  • Playset sizes — the per-game quantity the playset quick-add button on product cards adds. The product page’s playset button uses fixed sizes (4, or 3 for Yu-Gi-Oh! and Flesh and Blood) and doesn’t read these settings — its only control is the on/off switch in the product section.

Branding

SettingTypeWhat it does
FaviconImageSquare image (32×32 or larger) shown in the browser tab. PNG recommended.

Typography

Fonts

SettingTypeWhat it does
PrimaryFontDefault: work_sans_n4
HeadingsFontDefault: work_sans_n6

Headings

SettingTypeWhat it does
Section heading alignmentDropdownDefault alignment for section headings. Sections with their own alignment control (e.g. hero, rich text) override this. (Left, Center, Right)

Layout

SettingTypeWhat it does
Page widthDropdownNarrow, Wide
Page margin (desktop)SliderDefault: 20
Page margin (mobile)SliderDefault: 12

Colors

Each color pair includes a background and foreground (text) color designed to work together for accessibility.

Base colors

SettingTypeWhat it does
BackgroundColorDefault: #1a1a2e
ForegroundColorDefault: #f0f0f0

Secondary colors

SettingTypeWhat it does
Secondary backgroundColorDefault: #252542
Secondary textColorDefault: #f0f0f0

Accent colors

SettingTypeWhat it does
AccentColorDefault: #6366f1
Accent textColorDefault: #ffffff

Button colors

SettingTypeWhat it does
Button backgroundColorDefault: #6366f1
Button textColorDefault: #ffffff

Status colors

SettingTypeWhat it does
ErrorColorDefault: #ef4444
Error textColorDefault: #ffffff
WarningColorDefault: #f59e0b
Warning textColorDefault: #1a1a2e
SuccessColorDefault: #10b981
Success textColorDefault: #ffffff

Muted colors

SettingTypeWhat it does
MutedColorDefault: #4a4a6a
Muted textColorDefault: #9ca3af

Border

SettingTypeWhat it does
BorderColorDefault: #3d3d5c

Style

Corner radius

SettingTypeWhat it does
Border radius styleDropdownSets the global border radius that components can use (None (0px), Subtle (4px), Rounded (8px), Soft (16px), Pill (9999px), Custom)
Custom border radiusSliderOnly used when ‘Custom’ is selected above
Input corner radiusSliderDefault: 6
Button corner radiusSliderDefault: 6
Card corner radiusSliderDefault: 8
Badge corner radiusSliderDefault: 4

Social media

SettingTypeWhat it does
X (Twitter)Text
FacebookText
InstagramText
YouTubeText
TikTokText
DiscordText
TwitchText

Playset sizes

Configure the default playset quantity for quick-add buttons by trading card game. Each game has its own tournament-legal playset size.

SettingTypeWhat it does
PokemonSliderDefault: 4
Magic: The GatheringSliderDefault: 4
Yu-Gi-Oh!SliderDefault: 3
LorcanaSliderDefault: 4
Flesh and BloodSliderDefault: 3
One PieceSliderDefault: 4
Default (other games)SliderUsed for products not matching any specific game

Cart

SettingTypeWhat it does
Enable cart drawerOn / offShow a slide-in drawer instead of navigating to cart page
Open drawer when item addedOn / offAutomatically open the cart drawer when adding items
Drawer slide-in sideDropdownWhich edge the cart drawer slides in from. Right is conventional (matches the cart icon in the header). (Right, Left)

Collection filters

Manage filters in the Sideboard app: Apps → Sideboard → Filters.

SettingTypeWhat it does
Filter sourceDropdownWhich system powers the collection filter sidebar. Learn more (No filters, Search & Discovery filters, Sideboard filters)
Collapse + search long facets afterSliderA facet with more options than this many shows the first N with a “show more” toggle, plus a search box to narrow the list.
Option countsDropdownWhere each option’s count sits. Counts can be turned off per template with the collection section’s “Show filter counts” setting. (Right-aligned, Next to the label)
Options with no matchesDropdownSearch & Discovery filters only — Sideboard filters never show empty options. (Hide, Show greyed out)

Buylist

Controls where the “Sell Us This Card” button on product pages sends shoppers. Set your buylist slug to link straight to your Sideboard buylist (works even if the Sideboard app isn’t installed). Leave the slug blank to route through the Sideboard app proxy instead.

SettingTypeWhat it does
Buylist hostTextBase URL of your Sideboard buylist, no trailing slash (e.g. https://sideboard.gg).
Buylist slugTextYour store’s buylist handle — the part after /b/ (e.g. cardboard-crushers). When set, “Sell Us This Card” links directly to your buylist.

Card holo effect

A holographic-foil shimmer on card images: 3D tilt, specular glow, and iridescence that follow the cursor. Foil-finish cards shimmer on their own and intensify when a shopper picks the Foil finish.

SettingTypeWhat it does
Enable holo effectOn / offDefault: true
Show on product page imageOn / offDefault: true
Show on product cards (grids)On / offApplies to collection and search grids. The effect activates one card at a time on hover, so it stays light even on large pages.

Intensity

SettingTypeWhat it does
Tilt strengthSliderDefault: 12
Specular glowSliderDefault: 55
IridescenceSliderDefault: 50
Noise textureSliderDefault: 14
Motion speedSliderHigher = snappier tilt response.

Collection product cards

Card appearance for the collection grid. These also drive the cards on very large collections (5,000+ products), where the grid is rendered by Sideboard — so every card stays identical above and below that size.

Grid card

SettingTypeWhat it does
Show secondary image on hoverOn / offDefault: false
Show vendorOn / offDefault: false
Show condition/finish swatchesOn / offDefault: true
Show quick addOn / offDefault: true
Show playset quick-addOn / offDefault: true
Overlay options on imageOn / offDefault: false
Playset button goes to checkoutOn / offDefault: false
Mobile card styleDropdownAlways visible, Tap to expand, Expand button, Compact row

View mode

SettingTypeWhat it does
Default viewDropdownGrid, List
Enable list viewOn / offDefault: true

List card

SettingTypeWhat it does
Show imageOn / offDefault: true
Show set infoOn / offDefault: false
Show rarityOn / offDefault: true
Show condition swatchesOn / offDefault: true
Show priceOn / offDefault: true
Show quantityOn / offDefault: true
Show add to cartOn / offDefault: true

A site-wide left-rail navigation. Off by default. Turn it on to add the rail to every page, then add Menu and Text blocks in the Sidebar section.

SettingTypeWhat it does
Enable site-wide sidebarOn / offDefault: false

Show on

SettingTypeWhat it does
Home pageOn / offDefault: true
Collection pagesOn / offDefault: true
Product pagesOn / offDefault: false
Search pageOn / offDefault: true
Regular pagesOn / offDefault: false
Blog and articlesOn / offDefault: false

Behavior

SettingTypeWhat it does
Collapse menu groups by defaultOn / offDefault: true

Layout

SettingTypeWhat it does
HeadingTextDefault: Browse
WidthSliderDefault: 280
Padding topSliderDefault: 24
Padding bottomSliderDefault: 24
Padding inlineSliderDefault: 20
Gap between blocksSliderDefault: 24
Gap between itemsSliderDefault: 8

Was this page helpful?

Spotted something wrong, or want to suggest an improvement? Email support → — your message goes straight to engineering.