How to Upgrade the Hyvä Theme? – Simple Steps

Upgrading your Hyvä theme is a must to maintain its stability. 

In this blog, I will cover the simple steps to upgrade the Hyvä theme and related cases around it. 

But first, let’s understand the basics. 

Why Upgrade the Hyvä Theme?

Before jumping into the upgrade process, let’s understand why it’s necessary:

  • Upgrading Hyvä ensures your theme includes the latest security fixes, protecting your store from vulnerabilities
  • Each Hyvä release includes optimizations that improve website speed and efficiency, enhancing the overall user experience
  • Newer versions resolve previously known issues, ensuring your store performs smoothly and reliably
  • If you’re upgrading to the Magento 2.4.8 version, it’s critical to upgrade Hyvä as well. This helps to avoid version conflicts
  • Many Hyvä-compatible third-party extensions require a minimum Hyvä version. It is mandatory to upgrade to use newer modules or features

Understanding Two Core Components of Hyvä

When upgrading, it’s important to know that Hyvä consists of two main components:

hyva-themes/magento2-default-theme

This is the frontend theme that controls layout, Tailwind CSS styling, and Alpine.js behavior. Upgrading it provides:

  • Improved performance and UX
  • Visual/UI enhancements
  • New design features
  • Compatibility with new Magento features

hyva-themes/magento2-theme-module

This is the Magento backend module that powers the Hyvä theme. Upgrading it ensures:

  • Updated backend logic and helpers
  • Security and performance enhancements
  • Improved compatibility with Magento modules

Keeping both components updated is crucial to maintain a fast, secure, and modern eCommerce experience using Hyvä.

How To Check if Your Hyvä Theme Is Outdated?

You can check your current Hyvä version using the following SSH command:

composer show hyva-themes/magento2-theme-module
Check your current hyva version

This will return a result like:

hyva-themes/magento2-default-theme v1.3.13

After that, you can compare your version with the latest release on the official Hyvä GitLab repository or their changelog to get an idea about which version you need to upgrade.

Prerequisites for Upgrading Hyvä

Before proceeding, ensure you have the following:

  • Hyvä theme is already installed (any earlier version)
  • Magento version is 2.4.3 CE or higher
  • PHP version is 7.4, 8.1, or 8.2
  • Backup: Always take a complete backup of your files and database before upgrading

How to Upgrade Hyva Theme? 

Here, we will see upgrading both Hyva components. 

The current versions of magento2-default-theme and magento2-theme-module are 1.3.13, which we will upgrade to version 1.3.14 by following the steps below.

First, update the theme-module using the command below:

composer update hyva-themes/magento2-theme-module
Update the theme-module

This will be the final output:

Final output of updated theme module

Then, update the default-theme using the below command:

composer update hyva-themes/magento2-default-theme
Update the default theme

This will be the output: 

Final output of upated default theme

The versions are updated successfully!

Once the versions are successfully updated, proceed to run the standard Magento upgrade and deploy commands:

sudo php bin/magento se:up
sudo php bin/magento s:d:c
sudo php bin/magento s:s:d -f
sudo php bin/magento c:f

That’s it! 

While it may seem complex at first, once you begin, the process is straightforward and manageable.

If you are looking for a new Hyvä theme development for your store or upgrade the current Hyvä theme, our experts can help you, contact us today!

Sanjay Jethva

Article by

Sanjay Jethva

Sanjay is the co-founder and CTO of Meetanshi with hands-on expertise with Magento since 2011. He specializes in complex development, integrations, extensions, and customizations. Sanjay is one the top 50 contributor to the Magento community and is recognized by Adobe. His passion for Magento 2 and Shopify solutions has made him a trusted source for...