Skip to content

Theme Customization

Each theme in Shop Craft can have its own set of customizable settings. These settings let you fine-tune how the theme looks and behaves without needing to edit any code.

Accessing Theme Settings

  1. Log in to your Admin Panel
  2. Go to Themes in the sidebar
  3. Find the active theme (or any installed theme)
  4. Click the Settings icon (gear icon) on the theme card

This opens the theme settings page where you can adjust the available options.

What Can Be Customized

The available settings depend on the theme you are using. Each theme defines its own settings in its theme.json manifest file. Common settings include:

Setting TypeExamples
ColorsPrimary color, accent color, background color, text color
TypographyHeading font, body font
LayoutHeader style (compact vs. expanded), hero section style
Display togglesShow/hide elements like accent lines, brand bars, dark mode toggle
Border radiusSharp corners vs. rounded corners

Built-in Theme Settings

Boutique Theme

SettingTypeOptionsWhat It Does
Hero StyleDropdownEditorial, Split, MinimalChanges how the homepage hero banner is laid out
Show Brand BarToggleOn / OffShows or hides a decorative brand bar element on the storefront

Modern Minimal Theme

SettingTypeOptionsWhat It Does
Header StyleDropdownCompact, ExpandedControls the header height and layout. Compact is a slim sticky bar; expanded is taller with more spacing
Show Red Accent LineToggleOn / OffDisplays a thin red (#EF4444) line at the very top of every page

TIP

The Default theme does not currently have custom settings. Its appearance is controlled entirely by the Layout Editor and store branding settings (logo, favicon).

How to Change Settings

  1. Open the theme settings page (gear icon on the theme card)
  2. Adjust the settings using the form fields -- dropdowns, toggles, text inputs, or color pickers depending on what the theme offers
  3. Click Save to apply your changes

Changes take effect immediately after saving. Your customers will see the updated design right away.

Settings vs. Layout Editor

Theme settings and the Layout Editor serve different purposes:

Theme SettingsLayout Editor
What it controlsTheme-specific visual options (fonts, colors, component styles)Homepage sections, header layout, footer content
ScopeTied to a specific themeWorks across all themes
AccessAdmin > Themes > Settings (gear icon)Admin > Layout Editor

For customizing your homepage sections, header, and footer, use the Layout Editor. For adjusting the visual style of your current theme, use Theme Settings.

WARNING

If you switch to a different theme, the settings from your previous theme are preserved. If you switch back later, your old settings will still be there.

Shop Craft Documentation