Hyvä Version History: Complete Guide for Magento 2

If you run a Magento store on Hyvä, tracking version history helps you avoid conflicts, broken templates, and performance drops.

This guide explains major Hyvä version history, UI versions, checkout updates, and how to upgrade safely without risking your storefront.

What is Hyvä and Why Version History Matters

Hyvä Theme replaces Magento’s default Luma frontend with a lightweight stack built on Tailwind CSS and Alpine.js. 

It removes RequireJS and KnockoutJS, which dramatically reduces JavaScript weight and improves Core Web Vitals.

Because Hyvä simplifies Magento’s frontend architecture, even small updates can affect:

• Custom templates and third-party modules
• Checkout behavior and payment integrations
• UI components (sliders, modals, and menus)

With this theme also comes Hyvä UI, which is a library of pre-built, fully functional blocks like Mega Menus, Product Galleries, and Sliders. 

Upgrades here focus on features and UI/UX enhancements. Instead of building a “Sticky Add-to-Cart” from scratch, you simply pull the latest component from the UI library.

The Roadmap: Theme vs. UI Library

When planning an upgrade, it is vital to know whether you are updating the Foundation (Theme) or the Features (UI Library). They are versioned independently but work in tandem.

Major Hyvä Theme Version Milestones

The early Hyvä versions focused on performance and the later ones improved stability. 

• Hyvä 1.0 Performance Foundation: Replaced legacy stacks and saw Lighthouse scores jump from 30 to 90+.
• Hyvä 1.1 Stability: Refined production readiness with better fallback systems and Magento core compatibility.
• Hyvä 1.3 Security & Speed: Added stable support for Speculation Rules and full CSP compliance.
• Hyvä 1.4  The Open Source Shift: As of November 2025, the core theme became Open Source and Free. This version also introduced Tailwind v4 and native HTML dialogs.

Hyvä UI Version History

Hyvä UI evolves separately and directly affects your frontend components.

• Hyvä UI 2.1 – 2.2: Introduced the SplideJS-powered product galleries and the Ajax Add-To-Cart logic.
• Hyvä UI 2.4: Focused on “Sticky” elements, ensuring the Call-To-Action (CTA) is always reachable on mobile.
• Hyvä UI 2.6+: Switched from JavaScript-heavy modals to the Native HTML <dialog> element for better accessibility and performance.

How to Check Your Hyvä Theme and UI Versions

Use Composer to confirm installed versions before planning an upgrade.

Check Hyvä Theme

Run this command in your Magento root:

composer show hyva-themes/magento2-default-theme

Check Hyvä UI

composer show hyva-themes/magento2-hyva-ui

Always confirm alignment between your Magento version, Hyvä Theme, and PHP version (Hyvä 1.3.14+ is required for PHP 8.4).

When Should You Upgrade Hyvä?

Upgrade when compatibility, security, or checkout behavior is affected.

If new security patches are released, you are moving to a newer Magento version, or you need CSP compliance for high-security environments then update immediately. 

But, if you have significant custom template overrides or rely on complex B2B third-party modules then plan your upgrade carefully.

At Meetanshi, we handle Hyvä upgrades using a structured approach:

• Compatibility audit & Composer dependency analysis.
• Template override mapping (the #1 source of upgrade failure).
• Extension conflict testing.
• Performance benchmarking before and after.

If you are planning a migration or upgrade, our Hyvä development services focus on preserving performance while minimizing downtime.

Frequently Asked Questions 

Does Hyvä Follow Semantic Versioning?
Yes. Major releases (1.x, 2.x) involve structural shifts. Minor releases focus on features and stability.

Is Hyvä Theme free now?
Yes, as of version 1.4.0 (Nov 2025), the core Hyvä Theme is Open Source. Supporting products like UI, Enterprise, and Checkout remain commercial.

Hyvä Development Service

Get a fast-loading store in less than 7 weeks with Hyvä theme

Hire Us