Installing the extension

Go through the following steps to install the extension.

Prepare for installation

1. Back up your store's database and web directory.
2. Log in to the SSH console of your server and navigate to the root directory of your Magento 2 store.
3. Copy the installation instructions from the My Downloadable Products page and paste them into the SSH console. Press ENTER to proceed.

tip

To manually install the module in the app/code/ directory, download the archive from My Downloadable Products -> View & Download, unpack it, and copy the contents to Magento's root directory. Then, access your server via SSH, navigate to the Magento 2 root, and follow the installation steps.

Execute the following commands to install

1. Run the following command to enable the extension:

   php -f bin/magento module:enable Mirasvit_Core Mirasvit_CatalogLabel

2. Run the following command to install the extension:

   php -f bin/magento setup:upgrade

3. Clear the cache:

   php -f bin/magento cache:clean

4. Deploy static view files:

   rm -rf pub/static/*; rm -rf var/view_preprocessed/*;
   php -f bin/magento setup:static-content:deploy

If you are using the Hyvä theme

Hyvä support ships with the extension, so there is no compatibility module to install. On a Luma store the Hyvä part stays dormant. The extension carries its own Tailwind styles, so the theme has to be rebuilt once after installation.

1. Register the extension with the Hyvä build:

   bin/magento hyva:config:generate

2. Rebuild the theme assets:

   cd /path/to/theme/web/tailwind/
   npm run build-prod

3. Deploy static view files:

   cd /path/to/project/
   rm -rf pub/static/*; rm -rf var/view_preprocessed/*;
   php -f bin/magento setup:static-content:deploy

4. Flush the cache:

   bin/magento cache:flush

warning

Skipping the Tailwind rebuild leaves the labels unpositioned. The theme keeps serving the styles.css it was built with, and that file knows nothing about the position-* classes this extension puts on a placeholder — so a label renders under the product image instead of on top of it.

Note

Until version 2.6.0 Hyvä support was a separate package, mirasvit/module-cataloglabel-hyva, providing the Hyva_MirasvitCatalogLabel module. Both are gone. If the package is still installed on your store, upgrading the extension removes it by itself. See How to upgrade the extension.

In most cases nothing else is needed. If your theme is a custom Hyvä theme whose templates differ from the stock ones, see Customizations for Hyvä theme.

---

If you want to upgrade the extension, please refer to the how to upgrade the extension page.
To temporarily disable or remove it, use the commands from the how to disable the extension guide.