Hyvä Theme Settings
The Hyvä Theme Module (hyva-themes/magento2-theme-module) provides settings to optimize performance, control component behavior, and manage features. These settings cover deferred component loading, navigation prefetching, message display, and other storefront behaviors.
Find all Hyvä theme settings in the Magento Admin under Stores → Configuration → Hyvä Themes.
Version Compatibility
This reference covers settings from the latest version of hyva-themes/magento2-theme-module. The module can be safely updated to the latest version at any time.
General Settings
General settings manage message display, Alpine.js component initialization, and browser navigation speculation. They impact storefront page load performance and user experience.
| Setting | Description | Default Value |
|---|---|---|
| Message Display | ||
| Success Message Default Timeout | Set auto-hide timeout (ms) for success messages. Leave empty to disable. | (empty) |
| Hyvä Demo Content | ||
| Show Homepage Content | Show or hide Hyvä demo homepage content. | Yes |
| Deferred Alpine.js Components | ||
| Defer until idle timeout | Delay (ms) before initializing deferred Alpine.js components. | 4000 |
| Defer components | List Alpine.js components to defer. Note: Prioritize template-based deferral. | List of selectors |
| Speculation Rules | ||
| Method | Choose speculation method (`prefetch` or `prerender`). See docs. | Prefetch |
| Eagerness | Controls when to speculate on links (e.g., `immediate`, `eager`). | Moderate |
Catalog Settings
Catalog settings manage product comparison, recently viewed products, cross-sells, client-side breadcrumbs, and product list item caching. These settings influence product discovery, shopping experience, and catalog page performance.
| Setting | Description | Default Value |
|---|---|---|
| Compare Products | (Also in: Catalog → Catalog → Storefront) |
|
| Show Add To Compare On Product Page | Display 'Add to Compare' on product pages. | Yes |
| Show Add To Compare In Product List | Display 'Add to Compare' in product lists. | Yes |
| Show Compare Sidebar On Product List | Display compare sidebar in product lists. | Yes |
| Recently Viewed Products | (Also in: Catalog → Recently Viewed/Compared Products) |
|
| Enable Recently Viewed Products | Enable the recently viewed products feature. | No |
| Show Recently Viewed on Product Detail Pages | Display recently viewed block on product pages. | No |
| Show Recently Viewed on Product Listing Pages | Display recently viewed block in product lists. | No |
| Crosssell Products | ||
| Max Product Count for Crosssell list | Maximum cross-sell products to display in cart. | 4 |
| Client-Side Breadcrumbs | ||
| Enable on Product Detail Pages | Render breadcrumbs via JavaScript on PDPs. Warning: May be slow with large category trees. | No |
| Developer | ||
| Enable Product List Item block_html Caching | Cache HTML for product items on listings. | Yes |
| Product List Item Block Cache Lifetime | Cache lifetime (seconds) for product list items. | 3600 |
Google GTag Settings
Google GTag settings manage Google Analytics and Tag Manager integration. This includes IP anonymization for GDPR compliance and lazy loading the GTM script for better page performance.
| Setting | Description | Default Value |
|---|---|---|
| GTag | (Also in: Sales → Google API → Google GTag) |
|
| Anonymize IP | Anonymize IP addresses for Google tracking. | Yes |
| Lazyload Tag Manager | Defer GTM script loading until user interaction. | No |
Page Builder Settings
Page Builder settings control how Hyvä renders Adobe Commerce Page Builder content, including lazy loading background images to improve Core Web Vitals.
| Setting | Description | Default Value |
|---|---|---|
| Images | ||
| Enable lazy-loading for background images | Lazy-load Page Builder background images. Note: Requires default theme v1.3.10+. | No |
Developer Settings
Developer settings offer performance tuning options like SVG icon caching. Enabling SVG caching reduces PHP processing time but increases cache storage usage (e.g., Redis).
| Setting | Description | Default Value |
|---|---|---|
| Cache Options (SVG icons) | ||
| Enable SVG Icon Caching | Enable SVG icon caching. Increases cache storage usage (e.g., Redis). | No |
System Settings
System settings manage advanced caching, including browser back/forward cache (bfcache) for instant page restoration. These settings integrate with Magento's Full Page Cache.
| Setting | Description | Default Value |
|---|---|---|
| Cache Options (Bfcache) | (Also in: Advanced → System → Full Page Cache) |
|
| Enable Bfcache | Enable instant back/forward browser navigation cache. See docs. | No |