Hyvä Theme Settings
The Hyvä Theme Module (hyva-themes/magento2-theme-module) provides configuration options for performance optimization, component behavior, and feature toggles. These settings control deferred component loading, speculation rules for navigation prefetching, message display timeouts, and other storefront behaviors.
Access 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 control message display behavior, Alpine.js component initialization, and browser navigation speculation rules. These settings affect page load performance and user experience across the entire storefront.
| Setting | Description | Default Value |
|---|---|---|
| Message Display | ||
| Success Message Default Timeout | Auto-hide timeout for success messages, in milliseconds. Leave empty to disable. | (empty) |
| Hyvä Demo Content | ||
| Show Homepage Content | Show or hide the Hyvä demo homepage content. | Yes |
| Deferred Alpine.js Components | ||
| Defer until idle timeout | Delay in ms for initializing deferred Alpine.js components. | 4000 |
| Defer components | Lists Alpine.js components to defer. Note: Prefer handling in templates where possible. | List of selectors |
| Speculation Rules | ||
| Method | Speculation method (prefetch or prerender). See docs. |
Prefetch |
| Eagerness | Controls when to speculate on links (immediate, eager, etc.). |
Moderate |
Catalog Settings
Catalog settings control product comparison features, recently viewed products, cross-sell displays, client-side breadcrumbs, and product list item caching. These settings affect 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 | Show 'Add to Compare' on product pages. | Yes |
| Show Add To Compare In Product List | Show 'Add to Compare' in product lists. | Yes |
| Show Compare Sidebar On Product List | Show 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 | Show recently viewed block on product pages. | No |
| Show Recently Viewed on Product Listing Pages | Show recently viewed block in product lists. | No |
| Crosssell Products | ||
| Max Product Count for Crosssell list | Max cross-sell products to show in cart. | 4 |
| Client-Side Breadcrumbs | ||
| Enable on Product Detail Pages | Render breadcrumbs with JS on PDPs. Warning: Can be slow with large category trees. | No |
| Developer | ||
| Enable Product List Item block_html Caching | Cache the HTML of product items on listings. | Yes |
| Product List Item Block Cache Lifetime | Cache lifetime in seconds for product list items. | 3600 |
Google GTag Settings
Google GTag settings control Google Analytics and Tag Manager integration behavior, including IP anonymization for GDPR compliance and lazy loading of the GTM script to improve 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 blocks, including lazy loading behavior for background images to improve Core Web Vitals scores.
| 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 provide performance tuning options for advanced users, such as SVG icon caching. Enabling SVG caching reduces PHP processing time but increases cache storage usage in Redis or other cache backends.
| Setting | Description | Default Value |
|---|---|---|
| Cache Options (SVG icons) | ||
| Enable SVG Icon Caching | Enable at the cost of increased use of the cache storage backend (for example Redis). | No |
System Settings
System settings control advanced caching behavior, including browser back/forward cache (bfcache) support for instant page restoration during browser navigation. These settings integrate with Magento's Full Page Cache configuration.
| 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 |