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): this file is generated from config/settings_schema.json + locales/en.default.schema.json via scripts/generate-settings-index.py. Re-run that script after any theme-settings change to keep this doc in sync.
| 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 | toggle | ✗ | logo_static_show_inverse |
| Always show primary logo | toggle | ✗ | 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 — | | | |
| — Paragraph — | | | |
| Size | select (7 options) | 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 |
| Line height | select: Tight / Normal / Loose | tight | type_h1_line_height |
| Letter spacing | select: Tight / Normal / Loose | normal | type_h1_letter_spacing |
| Text transform | select: None / UPPERCASE / Capitalize | none | type_h1_transform |
| — Heading 2 — | | | |
| Font | select: Text / Subheading / Heading / Accent | heading | type_h2_font_role |
| Size | select (8 options) | 48px | type_h2_size |
| Line height | select: Tight / Normal / Loose | tight | type_h2_line_height |
| Letter spacing | select: Tight / Normal / Loose | normal | type_h2_letter_spacing |
| Text transform | select: None / UPPERCASE / Capitalize | none | type_h2_transform |
| — Heading 3 — | | | |
| Font | select: Text / Subheading / Heading / Accent | heading | type_h3_font_role |
| Size | select (7 options) | 36px | type_h3_size |
| Line height | select: Tight / Normal / Loose | tight | type_h3_line_height |
| Letter spacing | select: Tight / Normal / Loose | normal | type_h3_letter_spacing |
| Text transform | select: None / UPPERCASE / Capitalize | none | type_h3_transform |
| — Heading 4 — | | | |
| Font | select: Text / Subheading / Heading / Accent | heading | type_h4_font_role |
| Size | select (6 options) | 28px | type_h4_size |
| Line height | select: Tight / Normal / Loose | normal | type_h4_line_height |
| Letter spacing | select: Tight / Normal / Loose | normal | type_h4_letter_spacing |
| Text transform | select: None / UPPERCASE / Capitalize | none | type_h4_transform |
| — Heading 5 — | | | |
| Font | select: Text / Subheading / Heading / Accent | subheading | type_h5_font_role |
| Size | select: 16px / 18px / 20px / 22px / 24px | 22px | type_h5_size |
| Line height | select: Tight / Normal / Loose | normal | type_h5_line_height |
| Letter spacing | select: Tight / Normal / Loose | normal | type_h5_letter_spacing |
| Text transform | select: None / UPPERCASE / Capitalize | uppercase | type_h5_transform |
| — Heading 6 — | | | |
| Font | select: Text / Subheading / Heading / Accent | subheading | type_h6_font_role |
| Size | select: 14px / 15px / 16px / 18px / 20px | 18px | type_h6_size |
| Line height | select: Tight / Normal / Loose | normal | type_h6_line_height |
| Letter spacing | select: Tight / Normal / Loose | normal | type_h6_letter_spacing |
| Text transform | select: None / UPPERCASE / Capitalize | uppercase | type_h6_transform |
| Setting | Type | Default | ID |
|---|
| Dark / Light mode | toggle | ✗ | enable_dark_light_toggle |
| Global default scheme | scheme picker | scheme-1 | global_color_scheme |
| Default mode | select: Dark (primary) / Light (alternate) / Follow system preference | primary | dark_light_default_mode |
| Toggle position | select: In header / Floating bottom right / Floating bottom left | header | dark_light_toggle_position |
| — Global pair — | | | |
| Dark (global default) | scheme picker | scheme-1 | pair_1_primary |
| Light (global default) | scheme picker | scheme-2 | pair_1_alternate |
| Setting | Type | Default | ID |
|---|
| Page width | select: Narrow (1280px) / Default (1440px) / Wide (1760px) / Extra wide (2080px) / Custom | 90rem | max_page_width |
| Custom page width | range 800–2800px | 1440 | custom_page_width |
| Policy content width | range 600–1400px | 820 | policy_content_width |
| Page margin | range 0–80px | 20 | min_page_margin |
| Content padding (inner) | range 0–200px | 20 | section_inner_pad_x |
| Apply page margin to header | toggle | ✗ | header_apply_page_margin |
| Apply page width to header | toggle | ✗ | header_apply_page_width |
| Section spacing | range 0–120px | 40 | section_spacing |
| Gap between header and first section | range 0–200px | 40 | header_section_gap |
| Apply section spacing below footer | toggle | ✗ | spacing_below_footer |
| Global corner radius | range 0–32px | 12 | global_border_radius |
| — Mobile — | | | |
| Custom mobile layout | toggle | ✗ | enable_mobile_layout_overrides |
| Page margin (mobile) | range 0–24px | 6 | mobile_page_margin |
| Content padding (mobile) | range 0–32px | 4 | mobile_section_inner_pad_x |
| Section spacing (mobile) | range 0–80px | 12 | mobile_section_spacing |
| Touch hint instead of arrows (mobile) | toggle | ✗ | enable_mobile_touch_hint |
| — Product cards — | | | |
| Enable Quick Add | toggle | ✓ | enable_quick_add |
| Badge shape | select: Pill / Rounded / Square | pill | badge_shape |
| Badge corner radius | range 2–16px | 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 | toggle | ✗ | badge_show_new |
| Days a product stays ‘new’ | range 1–90d | 14 | badge_new_days |
| Show both Sale + New if applicable | toggle | ✗ | badge_show_both |
| Setting | Type | Default | ID |
|---|
| — Layout — | | | |
| Min height | range 50–120px | 70 | header_height |
| Horizontal padding | range 0–60px | 20 | header_padding_x |
| Vertical padding | range 0–20px | 0 | header_padding_y |
| Border radius | range 0–24px | 0 | border_radius |
| — Appearance — | | | |
| Background opacity | range 0–100% | 100 | bg_opacity |
| Enable glassmorphism | toggle | ✓ | enable_glass |
| Tint glass with scheme accent color | toggle | ✗ | glass_tint |
| Effect | select: None / Shadow / Glow | none | header_effect |
| Glow intensity | range 10–100% | 50 | glow_intensity |
| Apply effect to | select: Header bar only / Buttons only / Bar + buttons | both | effect_scope |
| Apply effect to logo | toggle | ✗ | apply_glow_to_logo |
| Use accent color for logo glow | toggle | ✗ | logo_glow_accent |
| Hide header bar | toggle | ✗ | hide_header_body |
| — Buttons — | | | |
| Color source | select (6 options) | link | header_btn_color_role |
| Hover color source | select (7 options) | auto | header_btn_hover_color_role |
| Hover background source | select: Button background (hover) / Button background / Accent / Glass tint (neutral) | button_hover | header_btn_hover_bg_role |
| Use a separate color for action icons | toggle | ✗ | header_btn_split_action_colour |
| Action icon color source | select (6 options) | 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 | toggle | ✗ | header_btn_custom_schemes |
| Dark mode scheme | scheme picker | scheme-1 | header_btn_scheme_plain |
| Light mode scheme | scheme picker | scheme-2 | header_btn_scheme_hover |
| Pill grouping | select: Off / Navigation only / Actions only / Both (nav + actions) | off | pill_grouping |
| 3D depth effect on buttons | toggle | ✗ | nav_btn_3d |
| Glass effect on buttons | toggle | ✗ | nav_btn_glass |
| Apply shape + effects to action buttons | toggle | ✓ | apply_shape_to_actions |
| — Search — | | | |
| Show search icon | toggle | ✓ | show_search |
| Search opens as | select: Popover (overlay) / Search page | popover | search_style |
| Setting | Type | Default | ID |
|---|
| — Behavior — | | | |
| Enable cart drawer | toggle | ✓ | enable_cart_drawer |
| Open drawer when items are added | toggle | ✓ | cart_drawer_open_on_add |
| — Layout — | | | |
| Width | range 320–560px | 420 | cart_drawer_width |
| Border radius (outside corners) | range 0–24px | 0 | cart_drawer_radius |
| — Color scheme — | | | |
| Use the active page color scheme | toggle | ✓ | cart_drawer_use_global_scheme |
| Drawer scheme | scheme picker | scheme-1 | cart_drawer_color_scheme |
| Drawer scheme (dark) | scheme picker | scheme-1 | cart_drawer_color_scheme_dark |
| Drawer scheme (light) | scheme picker | scheme-2 | cart_drawer_color_scheme_light |
| — Surface — | | | |
| Transparent background | toggle | ✗ | cart_drawer_transparent_bg |
| Enable glassmorphism | toggle | ✓ | cart_drawer_enable_glass |
| Tint glass with scheme accent color | toggle | ✗ | cart_drawer_glass_tint |
| Effect | select: None / Shadow / Glow | shadow | cart_drawer_effect |
| Glow intensity | range 10–100% | 50 | cart_drawer_glow_intensity |
| — Backdrop — | | | |
| Backdrop opacity | range 0–100% | 50 | cart_drawer_overlay_opacity |
| Backdrop blur | range 0–20px | 4 | cart_drawer_overlay_blur |
| — Express checkout — | | | |
| Show express payment buttons | toggle | ✓ | cart_drawer_show_dynamic_checkout |
| Setting | Type | Default | ID |
|---|
| — Glassmorphism — | | | |
| Glass blur | range 0–40px | 16 | glass_blur |
| Glass opacity | range 0–30% | 3 | glass_opacity |
| Glass saturation | range 100–200% | 140 | glass_saturate |
| Glass shine | toggle | ✗ | enable_glass_shine |
| Glass tint intensity | range 5–100% | 50 | glass_tint_intensity |
| — Section glow and shadow — | | | |
| Section glow intensity | range 50–200% | 100 | section_glow_intensity |
| Section shadow intensity | range 50–200% | 100 | section_shadow_intensity |
| — Animations — | | | |
| Enable scroll animations | toggle | ✓ | enable_scroll_animations |
| Animation style | select: Fade up / Fade down / Scale / None | fade-up | animation_style |
| Replay mode | select: Play once / Replay on scroll | once | animations_replay |
| Add-to-cart animation | toggle | ✓ | enable_cart_add_animation |
| Animation style | select: Bounce / Pop / Pulse / Wobble | bounce | cart_animation_style |
| Setting | Type | Default | ID |
|---|
| — Background image — | | | |
| Image (dark mode) | image_picker | — | background_image |
| Image (light mode) | image_picker | — | background_image_alternate |
| Always show dark-mode image | toggle | ✗ | background_keep_primary |
| Overlay opacity | range 0–100% | 92 | background_overlay_opacity |
| Scroll behavior | select: Fixed / Scroll with page | fixed | background_scroll_behavior |
| — X-Ray effect — | | | |
| Enable X-Ray | toggle | ✗ | enable_xray |
| X-Ray radius | range 20–800px | 200 | xray_size |
| Setting | Type | Default | ID |
|---|
| Enable frame | toggle | ✗ | enable_frame |
| Frame style | select: Line (border only) / Area (filled) | line | frame_style |
| Offset from edge | range 0–40px | 8 | frame_offset |
| — Padding per side — | | | |
| Top | range 0–80px | 0 | frame_padding_top |
| Right | range 0–80px | 0 | frame_padding_right |
| Bottom | range 0–80px | 0 | frame_padding_bottom |
| Left | range 0–80px | 0 | frame_padding_left |
| Border width | range 1–6px | 1 | frame_width |
| Frame scheme | scheme picker | scheme-1 | frame_scheme |
| Frame scheme (dark mode) | scheme picker | scheme-1 | frame_scheme_dark |
| Frame scheme (light mode) | scheme picker | scheme-2 | frame_scheme_light |
| Corner radius | range 0–32px | 16 | frame_radius |
| Opacity | range 5–100% | 20 | frame_opacity |
| Effect | select: None / Glow / Shadow | none | frame_effect |
| Effect position | select: Above content / Below content | above | frame_effect_position |
| Setting | Type | Default | ID |
|---|
| — Buttons — | | | |
| Button font | select: Text / Accent / Subheading / Heading | body | btn_font_role |
| Vertical padding | range 4–24px | 12 | btn_padding_y |
| Horizontal padding | range 8–64px | 24 | btn_padding_x |
| Text transform | select: None / UPPERCASE / lowercase / Capitalize | none | btn_text_transform |
| Border width | range 0–4px | 1 | btn_border_width |
| Button shape | select: Button (rounded) / Pill (full round) / Square (no radius) | button | variant_btn_style |
| Corner radius | range 0–32px | 8 | btn_border_radius |
| Glass button effect | toggle | ✗ | enable_glass_buttons |
| Glow on button hover | toggle | ✗ | enable_button_hover_glow |
| Glass color swatches | toggle | ✗ | enable_swatch_glass |
| — Inputs — | | | |
| Input shape | select: Button (rounded) / Pill (full round) / Square (no radius) | button | input_shape |
| Input corner radius | range 0–24px | 8 | input_corner_radius |
| Border width | range 1–4px | 1 | input_border_width |
| Glow on focus | toggle | ✗ | enable_input_glow |
| Setting | Type | Default | ID |
|---|
| Enable wishlist | toggle | ✓ | enable_wishlist |
| Show wishlist button on product page | toggle | ✓ | enable_product_wishlist_btn |
| — Heart button on product cards — | | | |
| Heart position | select: Top left / Top right / Bottom left / Bottom right | top-right | wishlist_heart_position |
| Heart style | select: Outline (filled on add) / Always filled | outline | wishlist_heart_style |
| Heart color when added | color picker | #f87171 | wishlist_heart_active_color |
| — Header link — | | | |
| Show wishlist icon in header | toggle | ✓ | show_wishlist_link |
| Wishlist page URL | url | — | wishlist_url |
| Setting | Type | Default | ID |
|---|
| Enable quick view | toggle | ✓ | enable_quick_view |
| Disable on mobile | toggle | ✗ | quick_view_disable_mobile |
| Always show icon on mobile | toggle | ✗ | quick_view_show_icon_mobile |
| — Trigger button — | | | |
| Button style | select: Icon only / Icon + text / Text only | icon | quick_view_trigger_style |
| Button position | select: Top right (over image) / Top left (over image) / Bottom right (over image) / Bottom left (over image) / Center on hover | center | quick_view_position |
| Glass background on button | toggle | ✓ | quick_view_glass |
| Tint glass with accent | toggle | ✗ | quick_view_glass_tint |
| — Modal — | | | |
| Surface | select: Solid / Glass / Tint glass with accent | glass | quick_view_surface |
| Match clicked card | toggle | ✗ | quick_view_inherit_card |
| Use custom color scheme | toggle | ✗ | quick_view_use_custom_scheme |
| Color scheme | scheme picker | scheme-1 | quick_view_color_scheme |
| Dark mode scheme | scheme picker | scheme-1 | quick_view_color_scheme_dark |
| Light mode scheme | scheme picker | scheme-2 | quick_view_color_scheme_light |
| Image aspect ratio | select (7 options) | 4-5 | quick_view_image_ratio |
| Show express payment buttons | toggle | ✗ | quick_view_show_dynamic_checkout |
| — Effects — | | | |
| Accent glow | toggle | ✗ | quick_view_glow |
| Drop shadow | toggle | ✗ | quick_view_shadow |
| Setting | Type | Default | ID |
|---|
| Enable sticky product bar | toggle | ✓ | enable_sticky_product_bar |
| — Content — | | | |
| Show product image | toggle | ✓ | sticky_bar_show_image |
| Show variant picker | toggle | ✓ | sticky_bar_show_variant_picker |
| Show quantity picker | toggle | ✓ | sticky_bar_show_quantity |
| — Appearance — | | | |
| Full-width bar | toggle | ✓ | sticky_bar_full_width |
| Glass background | toggle | ✗ | sticky_bar_glass |
| Tint glass with accent | toggle | ✗ | sticky_bar_glass_tint |
| Accent glow | toggle | ✗ | sticky_bar_glow |
| Drop shadow | toggle | ✗ | sticky_bar_shadow |
| — Behavior — | | | |
| Auto-hide after (ms) | range 0–5000ms | 0 | sticky_bar_show_until |
| Setting | Type | Default | ID |
|---|
| Enable schema emission | toggle | ✓ | enable_schema_emission |
| — Schema types — | | | |
| Organization schema | toggle | ✓ | emit_organization_schema |
| Website + sitelinks-search schema | toggle | ✓ | emit_website_schema |
| Product schema | toggle | ✗ | emit_product_schema |
| Article schema | toggle | ✓ | emit_article_schema |
| Breadcrumb schema | toggle | ✗ | emit_breadcrumb_schema |
| LocalBusiness schema | toggle | ✗ | emit_localbusiness_schema |
| FAQ schema (collapsible-content sections) | toggle | ✓ | emit_faq_schema |
| Video schema (video sections) | toggle | ✓ | emit_video_schema |
| HowTo schema (multicolumn how-to sections) | toggle | ✓ | emit_howto_schema |
| — Organization details — | | | |
| Organization name | text | — | organization_name |
| Organization logo | image_picker | — | organization_logo_url |
| Organization description | textarea | — | organization_description |
| Home page meta description | textarea | — | home_meta_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: (not set) / $ — Budget / $$ — Moderate / $$$ — Premium / $$$$ — Luxury | — | business_price_range |
| — Twitter / X — | | | |
| Twitter / X handle | text | — | twitter_handle |
| — Reviews threshold — | | | |
| Min reviews for aggregate rating | range 5–100 | 10 | aggregate_rating_min_reviews |
| Setting | Type | Default | ID |
|---|
| X (Twitter) | text | — | social_twitter |
| X (Twitter) — Custom icon | toggle | ✗ | social_twitter_custom_icon_enable |
| X (Twitter) — Custom icon image | image_picker | — | social_twitter_icon |
| Facebook | text | — | social_facebook |
| Facebook — Custom icon | toggle | ✗ | social_facebook_custom_icon_enable |
| Facebook — Custom icon image | image_picker | — | social_facebook_icon |
| Instagram | text | — | social_instagram |
| Instagram — Custom icon | toggle | ✗ | social_instagram_custom_icon_enable |
| Instagram — Custom icon image | image_picker | — | social_instagram_icon |
| TikTok | text | — | social_tiktok |
| TikTok — Custom icon | toggle | ✗ | social_tiktok_custom_icon_enable |
| TikTok — Custom icon image | image_picker | — | social_tiktok_icon |
| YouTube | text | — | social_youtube |
| YouTube — Custom icon | toggle | ✗ | social_youtube_custom_icon_enable |
| YouTube — Custom icon image | image_picker | — | social_youtube_icon |
| Pinterest | text | — | social_pinterest |
| Pinterest — Custom icon | toggle | ✗ | social_pinterest_custom_icon_enable |
| Pinterest — Custom icon image | image_picker | — | social_pinterest_icon |
| Discord | text | — | social_discord |
| Discord — Custom icon | toggle | ✗ | social_discord_custom_icon_enable |
| Discord — Custom icon image | image_picker | — | social_discord_icon |
| GitHub | text | — | social_github |
| GitHub — Custom icon | toggle | ✗ | social_github_custom_icon_enable |
| GitHub — Custom icon image | image_picker | — | social_github_icon |
| LinkedIn | text | — | social_linkedin |
| LinkedIn — Custom icon | toggle | ✗ | social_linkedin_custom_icon_enable |
| LinkedIn — Custom icon image | image_picker | — | social_linkedin_icon |
| Snapchat | text | — | social_snapchat |
| Snapchat — Custom icon | toggle | ✗ | social_snapchat_custom_icon_enable |
| Snapchat — Custom icon image | image_picker | — | social_snapchat_icon |
| Tumblr | text | — | social_tumblr |
| Tumblr — Custom icon | toggle | ✗ | social_tumblr_custom_icon_enable |
| Tumblr — Custom icon image | image_picker | — | social_tumblr_icon |
| Vimeo | text | — | social_vimeo |
| Vimeo — Custom icon | toggle | ✗ | social_vimeo_custom_icon_enable |
| Vimeo — Custom icon image | image_picker | — | social_vimeo_icon |
| Twitch | text | — | social_twitch |
| Twitch — Custom icon | toggle | ✗ | social_twitch_custom_icon_enable |
| Twitch — Custom icon image | image_picker | — | social_twitch_icon |
| Spotify | text | — | social_spotify |
| Spotify — Custom icon | toggle | ✗ | social_spotify_custom_icon_enable |
| Spotify — Custom icon image | image_picker | — | social_spotify_icon |
| — Custom social links — | | | |
| 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 |
