Every global theme setting in Hyprism, grouped by the tabs you see in the customizer (gear icon → theme settings).
This is an auto-generated reference document — searchable with Ctrl+F. Use it when you know what setting you need but not which tab it lives in.
For per-section / per-block settings, see the respective section chapter (6–10) or block reference inside the section docs.
ℹ️ Maintenance note (for developers): everything below the marker is generated from config/settings_schema.json + locales/en.default.schema.json by scripts/settings-index-erzeugen.py. Re-run it after any theme-settings change; do not edit the tables by hand.
| Setting | Type | Default | ID |
|---|
| color_schemes | color_scheme_group | — | color_schemes |
| Setting | Type | Default | ID |
|---|
| — Logo — | | | |
| Logo (standard) | image_picker | — | logo |
| Logo (inverted) | image_picker | — | logo_inverse |
| Show inverse logo | checkbox | ✗ | logo_static_show_inverse |
| Always show primary logo | checkbox | ✗ | logo_keep_primary |
| — Favicon — | | | |
| Favicon image | image_picker | — | favicon |
| Setting | Type | Default | ID |
|---|
| — Fonts — | | | |
| Body | font_picker | work_sans_n4 | type_body_font |
| Subheading | font_picker | work_sans_n4 | type_subheading_font |
| Heading | font_picker | ibm_plex_mono_n7 | type_heading_font |
| Accent | font_picker | ibm_plex_mono_n4 | type_accent_font |
| — Text presets — | | | |
| — Sizes automatically scale for all screen sizes. — | | | |
| — Paragraph — | | | |
| Size | select: 12px / 13px / 14px / 15px / 16px / 17px / 18px | 14px | type_body_size |
| Line height | select: Tight / Normal / Loose | normal | type_body_line_height |
| — Heading 1 — | | | |
| Font | select: Text / Subheading / Heading / Accent | heading | type_h1_font_role |
| Size | select (10 options) | 56px | type_h1_size |
| — Heading 2 — | | | |
| Font | select: Text / Subheading / Heading / Accent | heading | type_h2_font_role |
| Size | select: 24px / 28px / 32px / 36px / 40px / 48px / 56px / 64px | 48px | type_h2_size |
| — Heading 3 — | | | |
| Font | select: Text / Subheading / Heading / Accent | heading | type_h3_font_role |
| Size | select: 20px / 24px / 28px / 32px / 36px / 40px / 48px | 36px | type_h3_size |
| — Heading 4 — | | | |
| Font | select: Text / Subheading / Heading / Accent | heading | type_h4_font_role |
| Size | select: 18px / 20px / 22px / 24px / 28px / 32px | 28px | type_h4_size |
| — Heading 5 — | | | |
| Font | select: Text / Subheading / Heading / Accent | subheading | type_h5_font_role |
| Size | select: 16px / 18px / 20px / 22px / 24px | 22px | type_h5_size |
| — Heading 6 — | | | |
| Font | select: Text / Subheading / Heading / Accent | subheading | type_h6_font_role |
| Size | select: 14px / 15px / 16px / 18px / 20px | 18px | type_h6_size |
| Setting | Type | Default | ID |
|---|
| Dark / Light mode | checkbox | ✗ | enable_dark_light_toggle |
| Global default scheme | color_scheme | scheme-1 | global_color_scheme |
| Default mode | select (3 options) | primary | dark_light_default_mode |
| — Global pair — | | | |
| Dark (global default) | color_scheme | scheme-1 | pair_1_primary |
| Light (global default) | color_scheme | scheme-2 | pair_1_alternate |
| Toggle position | select: In header / Floating bottom right / Floating bottom left | header | dark_light_toggle_position |
| Setting | Type | Default | ID |
|---|
| Show low-stock counter | checkbox | ✓ | enable_stock_counter |
| Low-stock threshold | range | 10 | stock_counter_threshold |
| — Page — | | | |
| Page width | select (5 options) | 90rem | max_page_width |
| Custom page width | range | 1440 | custom_page_width |
| Page margin | range | 20 | min_page_margin |
| Section spacing | range | 40 | section_spacing |
| Global corner radius | range | 12 | global_border_radius |
| Advanced settings | checkbox | ✗ | layout_advanced |
| — Spacing — | | | |
| Content padding (inner) | range | 20 | section_inner_pad_x |
| Gap between header and first section | range | 40 | header_section_gap |
| Apply page margin to header | checkbox | ✗ | header_apply_page_margin |
| Apply page width to header | checkbox | ✗ | header_apply_page_width |
| Gap above first section (side header) | checkbox | ✗ | sidebar_first_section_gap |
| Apply section spacing below footer | checkbox | ✗ | spacing_below_footer |
| Policy content width | range | 820 | policy_content_width |
| — Mobile — | | | |
| Custom mobile layout | checkbox | ✗ | enable_mobile_layout_overrides |
| Page margin (mobile) | range | 6 | mobile_page_margin |
| Content padding (mobile) | range | 4 | mobile_section_inner_pad_x |
| Section spacing (mobile) | range | 12 | mobile_section_spacing |
| Touch hint instead of arrows (mobile) | checkbox | ✗ | enable_mobile_touch_hint |
| — Product cards — | | | |
| Badge shape | select: Pill / Rounded / Square | pill | badge_shape |
| Badge corner radius | range | 4 | badge_corner_radius |
| Badge position | select: Top left / Top right / Bottom left / Bottom right | top-left | badge_position |
| Badge size | select: Small / Medium / Large | medium | badge_size |
| Sale badge format | select: Percentage (-X%) / Absolute (-X$) / Text (Sale) | percent | badge_label_format |
| Show ‘New’ badge on recent products | checkbox | ✗ | badge_show_new |
| Days a product stays ‘new’ | range | 14 | badge_new_days |
| Show both Sale + New if applicable | checkbox | ✗ | badge_show_both |
| Dark gradient on product cards | checkbox | ✗ | card_scrim_enable |
| Gradient height | range | 65 | card_scrim_height |
| Gradient intensity | range | 90 | card_scrim_intensity |
| Gradient colour | color | #000000 | card_scrim_color |
| Key specs on the product card | select (4 options) | off | card_specs_mode |
| How many values | range | 4 | card_specs_count |
| Extra trigger for the key specs | select (3 options) | icon | card_specs_trigger |
| Compare button on the product card | checkbox | ✗ | card_compare |
| Where the comparison appears | select (3 options) | drawer | compare_display |
| How it opens | select: Automatically on the first save / Floating button | float | compare_trigger |
| EU values on the product card | select (4 options) | both | card_eu |
| Compliance metafield namespace | text | compliance | compliance_ns |
| Setting | Type | Default | ID |
|---|
| Min height | range | 70 | header_height |
| Enable glassmorphism | checkbox | ✓ | enable_glass |
| — ⚠️ The glass effect is switched off in Theme settings, so this option has no effect. Switch it back on, or clear the checkbox. — | | | |
| — Search — | | | |
| Show search icon | checkbox | ✓ | show_search |
| Search opens as | select: Popover (overlay) / Search page / Inline field in header | popover | search_style |
| Advanced settings | checkbox | ✗ | header_advanced |
| — Layout — | | | |
| Horizontal padding | range | 20 | header_padding_x |
| Vertical padding | range | 0 | header_padding_y |
| Border radius | range | 0 | border_radius |
| — Appearance — | | | |
| Background opacity | range | 100 | bg_opacity |
| Tint glass with accent | checkbox | ✗ | glass_tint |
| Effect | select: None / Shadow / Glow | none | header_effect |
| Apply effect to | select: Header bar only / Buttons only / Bar + buttons | both | effect_scope |
| Apply effect to logo | checkbox | ✗ | apply_glow_to_logo |
| Use accent color for logo glow | checkbox | ✗ | logo_glow_accent |
| Hide header bar | checkbox | ✗ | hide_header_body |
| — Buttons — | | | |
| Pill grouping | select: Off / Navigation only / Actions only / Both (nav + actions) | off | pill_grouping |
| 3D depth effect on buttons | checkbox | ✗ | nav_btn_3d |
| Glass effect on buttons | checkbox | ✗ | nav_btn_glass |
| — ⚠️ The glass effect is switched off in Theme settings, so this option has no effect. Switch it back on, or clear the checkbox. — | | | |
| Apply shape + effects to action buttons | checkbox | ✓ | apply_shape_to_actions |
| Style header buttons separately | checkbox | ✗ | header_btn_override |
| Color source | select: Text / Muted text / Link / Accent / Heading / Button label | button_label | header_btn_color_role |
| Hover color source | select (7 options) | auto | header_btn_hover_color_role |
| Hover background source | select (4 options) | button_hover | header_btn_hover_bg_role |
| — ⚠️ The glass effect is switched off in Theme settings, so this surface renders as a solid colour. Switch it back on, or set the surface to solid. — | | | |
| Use a separate color for action icons | checkbox | ✗ | header_btn_split_action_colour |
| Action icon color source | select: Text / Muted text / Link / Accent / Heading / Button label | accent | header_btn_action_color_role |
| Action icon hover color source | select (7 options) | auto | header_btn_action_hover_color_role |
| Use custom color schemes for header buttons | checkbox | ✗ | header_btn_custom_schemes |
| Dark mode scheme | color_scheme | scheme-1 | header_btn_scheme_plain |
| Light mode scheme | color_scheme | scheme-2 | header_btn_scheme_hover |
| Setting | Type | Default | ID |
|---|
| Enable cart drawer | checkbox | ✓ | enable_cart_drawer |
| Open drawer when items are added | checkbox | ✓ | cart_drawer_open_on_add |
| Surface | select: Solid / Transparent / Glass | glass | cart_drawer_surface |
| — ⚠️ The glass effect is switched off in Theme settings, so this surface renders as a solid colour. Switch it back on, or set the surface to solid. — | | | |
| Show express payment buttons | checkbox | ✓ | cart_drawer_show_dynamic_checkout |
| Advanced settings | checkbox | ✗ | cart_advanced |
| — Layout — | | | |
| Width | range | 420 | cart_drawer_width |
| Border radius (outside corners) | range | 0 | cart_drawer_radius |
| Merge drawer with frame | checkbox | ✗ | cart_drawer_connect_frame |
| — Color scheme — | | | |
| Use the active page color scheme | checkbox | ✓ | cart_drawer_use_global_scheme |
| Drawer scheme | color_scheme | scheme-1 | cart_drawer_color_scheme |
| Drawer scheme (dark) | color_scheme | scheme-1 | cart_drawer_color_scheme_dark |
| Drawer scheme (light) | color_scheme | scheme-2 | cart_drawer_color_scheme_light |
| — Surface — | | | |
| Tint glass with accent | checkbox | ✗ | cart_drawer_glass_tint |
| Effect | select: None / Shadow / Glow | shadow | cart_drawer_effect |
| Glow intensity | range | 50 | cart_drawer_glow_intensity |
| — Backdrop — | | | |
| Backdrop opacity | range | 50 | cart_drawer_overlay_opacity |
| Backdrop blur | range | 4 | cart_drawer_overlay_blur |
| Setting | Type | Default | ID |
|---|
| — Glassmorphism — | | | |
| Use glass effect | checkbox | ✓ | effects_glass |
| Glass blur | range | 16 | glass_blur |
| Glass opacity | range | 3 | glass_opacity |
| Glass saturation | range | 140 | glass_saturate |
| Glass shine | checkbox | ✗ | enable_glass_shine |
| Glass tint intensity | range | 50 | glass_tint_intensity |
| — Section glow and shadow — | | | |
| Use glow | checkbox | ✓ | effects_glow |
| Glow intensity (global) | range | 100 | section_glow_intensity |
| Use shadow | checkbox | ✓ | effects_shadow |
| Section shadow intensity | range | 100 | section_shadow_intensity |
| — Animations — | | | |
| Enable scroll animations | checkbox | ✓ | enable_scroll_animations |
| Animation style | select (6 options) | fade-up | animation_style |
| Replay mode | select: Play once / Replay on scroll | once | animations_replay |
| Section scroll motion | select: None / Fade at edges / Stack (sticky cards) | none | section_scroll_motion |
| Edge opacity | range | 15 | section_fade_min |
| Add-to-cart animation | checkbox | ✓ | enable_cart_add_animation |
| Cart badge animation style | select: Bounce / Pop / Pulse / Wobble | bounce | cart_animation_style |
| Page transition morph | checkbox | ✓ | enable_view_transitions |
| Preload product pages on hover | checkbox | ✓ | enable_vt_prerender |
| Image blur-up placeholder | checkbox | ✓ | enable_image_blur_up |
| Drawer & panel slide speed | range | 320 | drawer_slide_speed |
| Setting | Type | Default | ID |
|---|
| — Background image — | | | |
| Image (dark mode) | image_picker | — | background_image |
| Image (light mode) | image_picker | — | background_image_alternate |
| Overlay opacity | range | 92 | background_overlay_opacity |
| Advanced settings | checkbox | ✗ | bg_advanced |
| — Image — | | | |
| Always show dark-mode image | checkbox | ✗ | background_keep_primary |
| Scroll behavior | select: Fixed / Scroll with page | fixed | background_scroll_behavior |
| Background loading | select (2 options) | deferred | background_load_mode |
| Fade in over | range | 600 | background_fade_ms |
| — Overlay — | | | |
| Custom overlay colour | checkbox | ✗ | background_overlay_custom |
| Overlay colour | color | #0a0b0e | background_overlay_color |
| Overlay gradient | color_background | — | background_overlay_gradient |
| — X-Ray effect — | | | |
| Enable X-Ray | checkbox | ✗ | enable_xray |
| X-Ray radius | range | 200 | xray_size |
| — The reveal strength is controlled by the Background overlay opacity setting above. — | | | |
| Setting | Type | Default | ID |
|---|
| Enable frame | checkbox | ✗ | enable_frame |
| Frame style | select: Line (border only) / Area (filled) | line | frame_style |
| Offset from edge | range | 8 | frame_offset |
| Corner radius | range | 16 | frame_radius |
| Effect | select: None / Glow / Shadow | none | frame_effect |
| Opacity | range | 20 | frame_opacity |
| Advanced settings | checkbox | ✗ | frame_advanced |
| — Color scheme — | | | |
| Give the frame its own color scheme | checkbox | ✗ | frame_scheme_override |
| Frame color from scheme | color_scheme | scheme-1 | frame_scheme |
| Frame color from scheme (dark) | color_scheme | scheme-1 | frame_scheme_dark |
| Frame color from scheme (light) | color_scheme | scheme-2 | frame_scheme_light |
| — Padding per side — | | | |
| Top | range | 0 | frame_padding_top |
| Right | range | 0 | frame_padding_right |
| Bottom | range | 0 | frame_padding_bottom |
| Left | range | 0 | frame_padding_left |
| Border width | range | 1 | frame_width |
| Effect position | select: Above content / Below content | above | frame_effect_position |
| Setting | Type | Default | ID |
|---|
| Advanced settings | checkbox | ✗ | controls_advanced |
| — Buttons — | | | |
| Button shape | select: Button (rounded) / Pill (full round) / Square (no radius) | button | variant_btn_style |
| Corner radius | range | 8 | btn_border_radius |
| Button font | select: Text / Accent / Subheading / Heading | body | btn_font_role |
| Vertical padding | range | 12 | btn_padding_y |
| Horizontal padding | range | 24 | btn_padding_x |
| Text transform | select: None / UPPERCASE / lowercase / Capitalize | none | btn_text_transform |
| Button border width | range | 1 | btn_border_width |
| Glass button effect | checkbox | ✗ | enable_glass_buttons |
| — ⚠️ The glass effect is switched off in Theme settings, so this option has no effect. Switch it back on, or clear the checkbox. — | | | |
| Glow on button hover | checkbox | ✗ | enable_button_hover_glow |
| Glass color swatches | checkbox | ✗ | enable_swatch_glass |
| — ⚠️ The glass effect is switched off in Theme settings, so this option has no effect. Switch it back on, or clear the checkbox. — | | | |
| — Inputs — | | | |
| Input shape | select: Button (rounded) / Pill (full round) / Square (no radius) | button | input_shape |
| Input corner radius | range | 8 | input_corner_radius |
| Input border width | range | 1 | input_border_width |
| Glow on focus | checkbox | ✗ | enable_input_glow |
| — Back to top button — | | | |
| Show back to top button | checkbox | ✓ | enable_back_to_top |
| Surface | select: Solid / Glass / Transparent | solid | back_to_top_surface |
| — ⚠️ The glass effect is switched off in Theme settings, so this surface renders as a solid colour. Switch it back on, or set the surface to solid. — | | | |
| Icon | select: Chevron / Arrow / Double chevron / Caret | chevron | back_to_top_icon |
| Horizontal position | select: Left / Center / Right | right | back_to_top_position_h |
| Vertical position | select: Top / Bottom | bottom | back_to_top_position_v |
| Horizontal offset | range | 24 | back_to_top_offset_x |
| Vertical offset | range | 24 | back_to_top_offset_y |
| Hide when idle | checkbox | ✗ | back_to_top_idle_hide |
| Delay before hiding | range | 3 | back_to_top_idle_delay |
| Setting | Type | Default | ID |
|---|
| — Quick view lets shoppers preview a product (image gallery, variants, add-to-cart) in a modal without leaving the listing page. The quick-view button still needs to be enabled per product-grid block. — | | | |
| Enable quick view | checkbox | ✓ | enable_quick_view |
| Panel style | select: Floating (centred) / Slide-in panel | floating | quick_view_panel_mode |
| Surface | select: Solid / Glass | solid | quick_view_surface |
| — ⚠️ The glass effect is switched off in Theme settings, so this surface renders as a solid colour. Switch it back on, or set the surface to solid. — | | | |
| Tint glass with accent | checkbox | ✗ | quick_view_glass_tint |
| Show key specs | checkbox | ✗ | quick_view_specs |
| Number of rows | range | 6 | quick_view_specs_count |
| Advanced settings | checkbox | ✗ | qv_advanced |
| — Mobile — | | | |
| Disable on mobile | checkbox | ✗ | quick_view_disable_mobile |
| Always show icon on mobile | checkbox | ✗ | quick_view_show_icon_mobile |
| — Panel — | | | |
| Slide-in position | select: Right / Left / Top / Bottom | right | quick_view_panel_side |
| Panel width | range | 480 | quick_view_panel_width |
| Merge panel with frame | checkbox | ✗ | quick_view_connect_frame |
| — Trigger button — | | | |
| Button style | select: Icon only / Icon + text / Text only | icon | quick_view_trigger_style |
| Button position | select (5 options) | center | quick_view_position |
| Always show the button (desktop) | checkbox | ✗ | quick_view_always_visible |
| Glass background on button | checkbox | ✓ | quick_view_glass |
| — ⚠️ The glass effect is switched off in Theme settings, so this option has no effect. Switch it back on, or clear the checkbox. — | | | |
| — Modal — | | | |
| Match clicked card | checkbox | ✗ | quick_view_inherit_card |
| Use custom color scheme | checkbox | ✗ | quick_view_use_custom_scheme |
| Color scheme | color_scheme | scheme-1 | quick_view_color_scheme |
| Dark mode scheme | color_scheme | scheme-1 | quick_view_color_scheme_dark |
| Light mode scheme | color_scheme | scheme-2 | quick_view_color_scheme_light |
| Image aspect ratio | select (7 options) | 4-5 | quick_view_image_ratio |
| Show express payment buttons | checkbox | ✗ | quick_view_show_dynamic_checkout |
| — Effects — | | | |
| Accent glow | checkbox | ✗ | quick_view_glow |
| Drop shadow | checkbox | ✗ | quick_view_shadow |
| Setting | Type | Default | ID |
|---|
| — A compact bar that slides in from the bottom of the viewport on product pages once the main Add-to-cart button scrolls out of view. Lets shoppers add to cart from anywhere on the page without scrolling back up. — | | | |
| Enable sticky product bar | checkbox | ✓ | enable_sticky_product_bar |
| — Content — | | | |
| Show product image | checkbox | ✓ | sticky_bar_show_image |
| Show variant picker | checkbox | ✓ | sticky_bar_show_variant_picker |
| Show quantity picker | checkbox | ✓ | sticky_bar_show_quantity |
| Advanced settings | checkbox | ✗ | sticky_advanced |
| — Appearance — | | | |
| Full-width bar | checkbox | ✓ | sticky_bar_full_width |
| Glass background | checkbox | ✗ | sticky_bar_glass |
| — ⚠️ The glass effect is switched off in Theme settings, so this option has no effect. Switch it back on, or clear the checkbox. — | | | |
| Tint glass with accent | checkbox | ✗ | sticky_bar_glass_tint |
| Accent glow | checkbox | ✗ | sticky_bar_glow |
| Drop shadow | checkbox | ✗ | sticky_bar_shadow |
| — Behavior — | | | |
| Auto-hide after (ms) | range | 0 | sticky_bar_show_until |
| Setting | Type | Default | ID |
|---|
| — Structured data (JSON-LD Schema.org) emission for traditional search engines (Google, Bing) and AI-powered search (ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews). Validate output at https://validator.schema.org and https://search.google.com/test/rich-results. — | | | |
| Enable schema emission | checkbox | ✓ | enable_schema_emission |
| Organization name | text | — | organization_name |
| Home page meta description | textarea | — | home_meta_description |
| Append shop name to page title | checkbox | ✓ | append_shop_name_to_title |
| Advanced settings | checkbox | ✗ | seo_advanced |
| — Organization details — | | | |
| Organization logo | image_picker | — | organization_logo_url |
| Organization description | textarea | — | organization_description |
| — Business contact (LocalBusiness) — | | | |
| Business type | select (16 options) | LocalBusiness | business_type |
| Street address | text | — | business_street |
| Postal / ZIP code | text | — | business_postal_code |
| City / locality | text | — | business_city |
| Region / state | text | — | business_region |
| Country code | text | — | business_country |
| Phone number | text | — | business_phone |
| Contact email | text | — | business_email |
| Opening hours | text | — | business_opening_hours |
| Price range | select (5 options) | — | business_price_range |
| — Twitter / X — | | | |
| Twitter / X handle | text | — | twitter_handle |
| — Reviews threshold — | | | |
| Min reviews for aggregate rating | range | 10 | aggregate_rating_min_reviews |
| Setting | Type | Default | ID |
|---|
| — Networks — | | | |
| Instagram | text | — | social_instagram |
| Facebook | text | — | social_facebook |
| TikTok | text | — | social_tiktok |
| YouTube | text | — | social_youtube |
| Pinterest | text | — | social_pinterest |
| X (Twitter) | text | — | social_twitter |
| LinkedIn | text | — | social_linkedin |
| Advanced settings | checkbox | ✗ | social_advanced |
| — More networks — | | | |
| Discord | text | — | social_discord |
| GitHub | text | — | social_github |
| Snapchat | text | — | social_snapchat |
| Tumblr | text | — | social_tumblr |
| Vimeo | text | — | social_vimeo |
| Twitch | text | — | social_twitch |
| Spotify | text | — | social_spotify |
| — Custom links — | | | |
| — Add custom social media links with your own icons. — | | | |
| Custom link 1 - Label | text | — | social_custom_1_label |
| Custom link 1 - URL | text | — | social_custom_1_url |
| Custom link 1 - Icon | image_picker | — | social_custom_1_icon |
| Custom link 2 - Label | text | — | social_custom_2_label |
| Custom link 2 - URL | text | — | social_custom_2_url |
| Custom link 2 - Icon | image_picker | — | social_custom_2_icon |
| Custom link 3 - Label | text | — | social_custom_3_label |
| Custom link 3 - URL | text | — | social_custom_3_url |
| Custom link 3 - Icon | image_picker | — | social_custom_3_icon |
