berrypath/magento2-berrypath-flow

BerryPath Flow widget integration for Magento 2.

1.0.1 2026-06-16 08:05 UTC

Requires

• php: >=8.1

Suggests

• berrypath/magento2-berrypath-flow-hyva-compat: Hyva compatibility for BerryPath Flow.

MIT

README

Magento 2 module for the BerryPath Flow widget.

BerryPath helps ecommerce teams add guided selling, product finder flows and guided product advice to their webshop. In Magento 2, this module makes those Flow widgets available on category pages, product detail pages and CMS/widget placements.

The category banner title and description are rendered as regular Magento HTML, so merchants can add relevant, indexable context around product advice flows.

Installation

composer require berrypath/magento2-berrypath-flow
bin/magento module:enable BerryPath_Flow
bin/magento setup:upgrade
bin/magento cache:flush

For local app/code development, place it at:

app/code/BerryPath/Flow

Configuration

Global settings are in:

Stores > Configuration > BerryPath > Flow

Use this for global enable/disable, market code, product ID source and the success pixel.

Enable the widget per page by entering a Flow UUID:

• Category: Catalog > Categories > BerryPath Flow
• Product: Catalog > Products > BerryPath Flow
• CMS/widget usage: Magento widget BerryPath Flow

If no Flow UUID is set on the category, product or widget, nothing is rendered.

The success pixel is enabled by default. On the Magento checkout success page it loads the main berrypath.js file and passes the order total plus product identifiers through window.BerryPath.conversion(...) for assisted conversion tracking.

Hyva

For Hyva storefronts, install the separate compatibility module:

• Package: berrypath/magento2-berrypath-flow-hyva-compat

The Hyva module replaces the frontend templates through hyva-themes/magento2-compat-module-fallback.

Screenshots