Hyvä Enterprise Installation & Configuration

Hyvä Enterprise extends Hyvä Themes and Hyvä Checkout with compatibility modules for Adobe Commerce enterprise features including B2B, Live Search, and Product Recommendations. This guide covers system requirements and installation procedures for all Hyvä Enterprise metapackages.

Hyvä Enterprise is a stand-alone commercial product

A separate Hyvä Enterprise license is required in addition to your Hyvä Themes and/or Hyvä Checkout licenses.

System Requirements Overview

Before installing Hyvä Enterprise, verify your environment meets the requirements below. Requirements are organized by feature area—only install the prerequisites for the features you plan to use.

Core Platform Requirements

The following requirements apply to all Hyvä Enterprise installations:

Adobe Commerce 2.4.4 or higher

The current implementation is based on 2.4.6. Thorough testing has not yet been undertaken for 2.4.4/2.4.5, and therefore, some issues may arise. At present B2B requires 2.4.6 and above, but earlier version support is being reviewed.
Hyvä Themes 1.2.9, 1.3.10 or higher

Some older versions support earlier 1.3.x versions
Hyvä Checkout 1.3.0 or higher

This is only required if making use of checkout features, and requires a Hyvä Checkout license

Some older versions support earlier 1.1.x and 1.2.x versions
PHP 8.0 or newer

For convenience, the Release notes of products related to Hyvä Enterprise can be found at

B2B Suite Requirements

If you plan to use Adobe Commerce B2B features (company accounts, shared catalogs, requisition lists, quote templates, purchase orders), you must install and configure Adobe's B2B extension before installing Hyvä Enterprise B2B.

magento/extension-b2b 1.4.0 or higher

Support for 1.3.x to allow compatibility with Adobe Commerce 2.4.4 and 2.4.5 is being reviewed.

Follow Adobe's B2B installation guide to configure the B2B extension. See B2B release notes for version-specific information.

Adobe Sensei Services Requirements

Adobe Sensei provides AI-powered search and product recommendations for Adobe Commerce. If you plan to use Live Search or Product Recommendations, install and configure the respective Adobe modules before installing Hyvä Enterprise Sensei compatibility.

Live Search

Live Search provides search results with faceted filtering provided by Adobe Sensei AI. The following package is required:

magento/live-search 3.0.0 or higher

Follow Adobe's Live Search installation guide to configure the service. See Live Search release notes for version details.

Product Recommendations

Product Recommendations displays AI-driven product suggestions throughout your storefront. The following packages are required:

magento/product-recommendations 5.0.0 or higher
magento/module-page-builder-product-recommendations 2.0.0 or higher
magento/module-visual-product-recommendations 2.0.0 or higher

Follow Adobe's Product Recommendations installation guide to configure the service. See Product Recommendations release notes for version details.

Adobe Data Connection Requirements

Adobe Data Connection enables behavioral data collection for Adobe Experience Platform integration. If you plan to send storefront event data to Adobe Experience Platform, install the Experience Connector before installing Hyvä Enterprise Data Connection compatibility.

magento/module-experience-connector

Follow Adobe's Data Connection installation guide to configure the connector. See Data Connection release notes for version details.

Installation

Hyvä Enterprise provides separate metapackages for different feature sets. Install only the metapackages that correspond to the Adobe Commerce features you use. All packages are installed via Composer using your Hyvä packagist.com license key.

Installing Enterprise for Hyvä Themes

Hyvä Enterprise for Hyvä Themes provides frontend compatibility for Adobe Commerce enterprise features. Choose the appropriate metapackage(s) based on which Adobe Commerce features you need to support.

Before you begin: Ensure you have completed the following prerequisites:

Installed and configured Hyvä Themes
Installed any Adobe Commerce features you plan to use (B2B, Live Search, Product Recommendations, Data Connection)

Installation steps:

Choose and install the appropriate metapackage(s) for your feature requirements:
Adobe Commerce base features (Google Tag Manager, customer attributes, ...)

Install the base metapackage for Adobe Commerce compatibility:
Install Adobe Commerce compatibility metapackage
```
composer require hyva-themes/magento2-hyva-enterprise-commerce
bin/magento setup:upgrade
```
B2B features (company accounts, shared catalogs, quote templates, purchase orders, ...)

Install the B2B metapackage for Adobe Commerce B2B compatibility. This package automatically includes the base metapackage as a dependency:
Install B2B metapackage
```
composer require hyva-themes/magento2-hyva-enterprise-b2b
bin/magento setup:upgrade
```
Data Connection (Adobe Experience Platform integration)

Install the Data Connection metapackage for Adobe Experience Platform event tracking:
Install Data Connection metapackage
```
composer require hyva-themes/magento2-hyva-enterprise-data-connection
bin/magento setup:upgrade
```
Live Search (Adobe Sensei search)

Install the Live Search metapackage for Adobe Sensei Live Search compatibility:
Install Live Search metapackage
```
composer require hyva-themes/magento2-hyva-enterprise-live-search
bin/magento setup:upgrade
```
Product Recommendations (AI-driven product suggestions)

Install the Product Recommendations metapackage for Adobe Sensei Product Recommendations compatibility:
Install Product Recommendations metapackage
```
composer require hyva-themes/magento2-hyva-enterprise-product-recommendations
bin/magento setup:upgrade
```
DEPRECATED: Adobe Sensei combined metapackage

Deprecated metapackage

The combined Adobe Sensei metapackage is deprecated. Install the Data Connection, Live Search, and Product Recommendations metapackages separately instead.
Deprecated Sensei metapackage
```
composer require hyva-themes/magento2-hyva-enterprise-sensei
bin/magento setup:upgrade
```
Metapackage dependencies

The B2B and Sensei-related metapackages include the base Adobe Commerce metapackage as a dependency. You do not need to install the base metapackage separately when using B2B or Sensei features.
Build the Tailwind CSS to include styles from the newly installed compatibility modules. Replace the path below with the path to your theme's web/tailwind folder:
Build Tailwind CSS for Hyvä Themes
```
npm --prefix vendor/hyva-themes/magento2-default-theme/web/tailwind/ ci
npm --prefix vendor/hyva-themes/magento2-default-theme/web/tailwind/ run build
```

Installing Enterprise for Hyvä Checkout

Hyvä Enterprise for Hyvä Checkout provides checkout-specific compatibility for Adobe Commerce enterprise features. These packages extend the base Hyvä Checkout with B2B checkout flows and enterprise feature support.

Hyvä Enterprise for Hyvä Checkout consists of 2 metapackages - Adobe Commerce & B2B - which can be installed via your Hyvä packagist.com license key.

Adobe Sensei compatibility for checkout

Support for Live Search and Product Recommendations in checkout is under review to determine if code changes are required. Currently, Sensei-related functionality is handled by the theme-level packages.

Before you begin: Ensure you have completed the following prerequisites:

Installed and configured Hyvä Themes
Installed and configured Hyvä Checkout
Installed any Adobe Commerce features you plan to use

Installation steps:

Choose and install the appropriate metapackage(s) for your feature requirements:
Adobe Commerce checkout features (custom customer attributes)

Install the Commerce Checkout metapackage for enterprise checkout features without B2B:
Install Commerce Checkout metapackage
```
composer require hyva-themes/magento2-hyva-enterprise-commerce-checkout
bin/magento setup:upgrade
```
B2B checkout features (company checkout, purchase orders, quote templates)

Install the B2B Checkout metapackage for B2B-specific checkout features. This package automatically includes the magento2-hyva-enterprise-commerce-checkout metapackage as a dependency:
Install B2B Checkout metapackage
```
composer require hyva-themes/magento2-hyva-enterprise-b2b-checkout
bin/magento setup:upgrade
```
Metapackage dependencies

The B2B Checkout metapackage includes the base Commerce Checkout metapackage as a dependency. You do not need to install the Commerce Checkout metapackage separately when using B2B features.
Build the Tailwind CSS to include styles from the newly installed compatibility modules. Replace the path below with the path to your theme's web/tailwind folder:
Build Tailwind CSS for Hyvä Checkout
```
npm --prefix vendor/hyva-themes/magento2-default-theme/web/tailwind/ ci
npm --prefix vendor/hyva-themes/magento2-default-theme/web/tailwind/ run build-prod
```

Configuring Customer Custom Attributes in Checkout

If you use Customer Custom Attributes in Adobe Commerce, you can configure which attributes appear on the checkout address forms.

Admin configuration location: Navigate to Stores > Configuration > Hyvä Themes > Checkout > Components and locate the shipping/billing address groups to configure attribute display settings.

Customer Custom Attributes compatibility

Customer Custom Attributes is not yet fully supported at checkout. See the Hyvä Enterprise compatibility tracker for current status and known limitations.