Prerequisites

• License for Shopware 6.1.0 and higher.
• License for Voyado Engage
• Product feeds connected to Voyado Engage for each market locale (Ex: sv-SE).
• Engage Email Template

Set Up the Voyado Extension in Shopware

This guide provides step-by-step instructions for integrating Voyado with your Shopware store.

1. Login to Shopware Admin
   • Access your Shopware admin panel.
2. Install the Voyado Extension
   • Navigate to Extensions > Store.
   • In the Find extensions search field, search for "Voyado".
   • Select the Voyado extension and click on Add extension.
   • Once added, click on Install extension.
3. Activate and Configure the Extension
   • Go to Marketing > Voyado Configuration.
   • Copy the Store ID and securely send it to your Voyado team.
   • The team will notify you when the extension is configured.

Sales channel and store mapping

This section enables you to track where customers register and ship their orders by mapping Engage stores to shipping countries in Shopware. The mapped data can be used as filters for automation and segmentation.

Engage Store

An Engage Store is an entity that can be linked to both a customer and an order, allowing for more detailed segmentation within an Engage Environment. It supports mapping by country or location, including brick-and-mortar stores.

Map Sales channels in Engage

Make sure to create your eCommerce stores in Engage prior to these steps. Learn more here.

1. Log in to Shopware admin
2. Navigate to Marketing Voyado Configuration.
3. Under the Store and Country Mapping section, select your Sales Channel.
4. Set a fallback Engage store:
   • Choose the Engage Store that will be used as a fallback.
   • Any country that has not been mapped will default to this store.
5. Map specific countries:
   • Click Add New Option to map a country to an Engage Store.
6. Repeat step 5 for all countries you wish to map.

Cookie management for Web Activity Tracking

When the Voyado app is installed in Shopware, it automatically adds a cookie consent entry for Voyado Analytics under the Marketing consent group in Shopware’s default cookie banner. This ensures that tracking is compliant with privacy regulations and only runs with the user's explicit consent.

Troubleshooting cart tracking 

If cart tracking is not functioning as expected, it may be due to missing custom Twig blocks from the Voyado app in your Shopware theme.

By default, the app injects custom blocks into your theme's template files during installation. However, in some cases—such as when using a custom theme or after modifying theme files—these blocks may not be properly included.

How to Fix It

There are two options to resolve the issue:

1. Reinstall the App
   This will attempt to reapply the customizations automatically.
2. Manually Add the Custom Twig Block
   If you prefer manual control or are using a highly customized theme, you can manually add the required Twig block.

Affected File:
cart-widget.html.twig

Required Code:

{# Extend the default Shopware cart widget template #}
{% sw_extends '@Storefront/storefront/layout/header/actions/cart-widget.html.twig' %}

{# Override the cart widget block to include custom tracking data #}
{% block layout_header_actions_cart_widget %}
    {{ parent() }}

    {# Custom block for tracking cart changes #}
    {% block voyado_layout_header_actions_cart_widget %}
        {% set filtered_cart_items = [] %}

        {% for item in page.cart.lineItems %}
            {% if item.type != 'promotion' %}
                {% set filtered_cart_items = filtered_cart_items|merge([item]) %}
            {% endif %}
        {% endfor %}

        {% set cart_data = filtered_cart_items|json_encode %}
        {# Store Cart Tracking Data #}
    {% endblock %}
{% endblock %}

Make sure this template is correctly placed and loaded in your theme so the cart data can be tracked and sent to Voyado Engage.

Article last reviewed 13 January 2026 14:09