Search

Shopware 6 plugin - Installation and set up

This plugin is developed and maintained by a third party. Brevo does not provide support for this plugin. For related questions or issues, log into your Shopware account and create a ticket.
The current documented plugin version is 5.1.0, compatible with Shopware 6 6.7 or higher. If you are using another version of the plugin or Shopware 6, some features or settings may be missing or appear differently.

shopware-6.png

Download the Shopware 6 plugin

Connect your Shopware 6 store to Brevo to sync your contacts, track orders and revenue, automate marketing campaigns, and engage your customers with email, SMS, and live chat all from one unified platform.

About the Brevo plugin for Shopware 6

Learn more about the plugin's features, use cases, and limitations in the following tabs:

Main featuresUse casesLimitations

Install the plugin

You can install the Brevo plugin using the Shopware Plugin Manager or by uploading the plugin file directly.

Step 1: Install and activate the plugin

To install the Brevo plugin for Shopware 6:

  1. Log in to your Shopware 6 admin dashboard.
    💡 Good to know
    You can access your Shopware 6 admin dashboard by adding /admin to your website URL (e.g. the-green-yoga.com/admin).
  2. Go to Extensions > Store.
  3. In the search bar, type Brevo and find the Brevo: Email & Online Marketing Platform plugin in the search results.
    search-extension_EN-US.png
  4. Click Add extension.
  5. Go to Extensions > My extensions.
  6. Click Install next to the plugin.
  7. Activate the Brevo plugin.
    shopware_activate-plugin_EN-US.jpeg

Step 2: Connect your Shopware 6 store to Brevo

Once the plugin is activated, connect your Shopware store to your Brevo account:

  1. Go to Extensions > My extensions.
  2. Next to the Brevo plugin name, click the three dots icon ··· > Open extension.
    shopware_open-extension-settings_EN-US.jpeg
  3. From the dropdown, select the sales channel you want to connect to Brevo.
  4. Click Connect to Brevo. You'll be redirected to Brevo.
    shopware_connect-Brevo_EN-US.jpeg
  5. Log into your account or create a new one.
  6. Click Allow access to authorize the connection.
    allow_access.png
  7. Click Activate to start configuring the plugin settings.

The Brevo plugin for Shopware 6 is now installed and connected. You can start synchronizing your contacts and orders, tracking page visits, and more.

Access the plugin settings

To set up your Brevo plugin for Shopware, access its settings:

  1. In Brevo, click the account dropdown and select Integrations > My integrations.
  2. Next to your Shopware 6 integration, click the three-dot icon and select Edit settings.
    shopware6_edit-settings_en-us.png

Sync your Shopware 6 contacts to Brevo

⚠️ Important

In Shopware 6.7, only customers who explicitly subscribed to your newsletter are synced as subscribed contacts in Brevo. Regular store customers (those who made purchases but did not subscribe to your newsletter) are synced as blocklisted to comply with privacy regulations. To add these customers to your marketing campaigns, you must first invite them to subscribe to your newsletter through an email or promotional banner.

💡 Good to know
When you sync your Shopware 6 contacts to Brevo, your eCommerce data is also synced automatically, and the Brevo tracker is installed on your store to track customer activity in real time. To learn more, check our dedicated section.

Sync your Shopware 6 contacts to Brevo. Existing contacts are synced during the initial setup, while new and updated ones are synced in real time.

Step 1: Configure your contact sync settings

Configure how your Shopware 6 contacts are synced to Brevo. These settings are applied to both existing and new contacts.

  1. From the plugin settings, click Contact Synchronization.
  2. Activate the Sync your store contacts to Brevo option to allow the plugin to sync your Shopware 6 contacts to Brevo.
  3. (Optional) Activate the Syncing of customers in addition to newsletters subscribers option to sync all your Shopware 6 contacts, including guest checkouts in Brevo.

  4. Select the Brevo list where your Shopware 6 contacts will be synced:

    If “Syncing of customers” is activated

    By default, all contacts including guest checkouts are added to a new list named Shopware 6 in your Integrations folder in Brevo. Click Select another list to choose or create a different one.
    shopware_contact-sync_activated_select-list_en-us.png

    If “Syncing of customers” is deactivated

    Customers who are subscribed to your newsletter are added to a new list named Shopware6 in your Integrations folder in Brevo. Click Select another list to choose or create a different one.
    shopware_contact-sync_deactivated_select-list_en-us.png

    All other contacts are added to Shopware6_NonSubscribers in your Integrations folder. This list cannot be changed.

  5. By default, the Sync the state of contacts (subscribed/unsubscribed) option is activated. This automatically updates the status of your contacts on Brevo and on your Shopware 6 store.
  6. By default, the Autoassign store contacts' attributes to Brevo contact attributes option is activated. This automatically maps the email address, first name, and last name of your Shopware 6 contacts to the corresponding attributes in Brevo.
    If you want to map more attributes manually, deactivate this option and click Map attributes.
  7. Click Save. 

The sync of your existing Shopware 6 contacts begins.

Step 2: Monitor the sync and view your contacts

The initial sync of your Shopware 6 contacts may take a few minutes, depending on the size of your list.

To monitor the sync progress:

  1. From the plugin settings, click Go back to My Integrations.
  2. Next to your Shopware 6 integration, click the three-dot icon and select Sync details.
    shopware6_sync-details-us.png

You’ll see a detailed view of the sync status and progress.

Once syncing is complete, you can view your contacts in Brevo under CRM > Contacts. Each synced contact includes the following attributes to help with filtering, segmentation, and tracking:

Attribute Example
SW_SUBSCRIPTION_STATUS
  • subscribed: The contact is subscribed to your email marketing.
  • not subscribed: The contact has not subscribed to your email marketing.
  • unsubscribed: The contact has explicitly unsubscribed from your email marketing.
SW_DOUBLE_OPTED
  • opted: the contact has subscribed to your email marketing and confirmed their subscription by clicking the link in the double opt-in email (i.e., double opt-in confirmed).
  • pending: the contact has subscribed to your email marketing but has not yet confirmed their subscription by clicking the link in the double opt-in email (i.e., double opt-in pending).
  • not-set: the contact has subscribed to your email marketing through a simple opt-in process without double opt-in.
  • not-opted: the contact has not subscribed to your email marketing.
SW_USER_ID The unique ID of the contact in your Shopware store (e.g., 4325).
SW_SHOP_URL The URL of the store from which the contact was synced (e.g., mystore.com)
CONTACT_SOURCE The platform from which the contact was synced (e.g., Shopware).

Manage your contacts' opt-in process

❗️ Important
You have to activate contact synchronization to access this feature.

To manage your subscription settings:

  1. From the plugin settings, click Subscription Confirmation.
  2. Activate the Use Brevo subscription confirmation to manage opt-in settings option. 
    woocommerce_subscription-confirmation_EN-US.gif
  3. Choose how your contacts' subscription will be confirmed to them after they submit the sign-up form:
    [Recommended] Double confirmation emailSimple confirmation email

    We highly recommend using a double confirmation email to comply with GDPR. After submitting the sign-up form, your contacts receive an email containing a double opt-in link. They will be added to your list of Shopware contacts only after clicking this double opt-in link. 

    1. Select from the drop-down list the double opt-in confirmation email template you want to send to your contacts when they submit the sign-up form. You can choose either: 
    2. (Optional) You can redirect your contacts to a specific website page or a landing page after they click the double opt-in link. Just paste the URL to this specific website page or landing page in the field. 
    3. (Optional) You can send a final confirmation email to your contacts after they click the double opt-in link. You can choose either: 
      • Default template Simple confirmation, 
      • Default template - Unsubscription Follow Up, or 
        To edit the default templates, go to Marketing > Templates > Email.
      • Your custom simple confirmation template. 
        To learn more, check our dedicated article Create an email template.
        woocommerce_double-confirmation-email_EN-US.png
  4. Click Save to confirm your subscription confirmation settings. 

Your contacts' opt-in process is now set up! 🚀 Each contact will be informed of their subscription to your marketing emails. 

Synchronize your orders

Syncing your Shopware eCommerce data to Brevo allows you to:

  • View your products, categories, orders, and customers directly in your Brevo eCommerce dashboard.
  • Install the Brevo tracker on your WooCommerce store and track customer activity, including product views, cart additions, and purchases.

Step 1: Access your eCommerce data in Brevo

Your Shopware eCommerce data, including products, categories, orders, and customers, is synced to Brevo and can be accessed from the eCommerce dashboard. Existing data is synced during the initial setup, while new products, categories, orders, and customers are synced in real time.

  1. From the plugin settings, click Ecommerce Attribute Synchronization.
  2. The Enable the sync of e-commerce attributes option is automatically activated when you sync your Shopware 6 contacts to Brevo to allow the plugin to sync your WooCommerce eCommerce data to Brevo and start tracking customer activity.
  3. Under the Sync Statuses section, you can monitor the sync status of your eCommerce attributes. The initial sync of your Shopware 6 contacts may take a few minutes, depending on the number of products, categories, orders, and customers being synced.
  4. (Optional) Click View Ecommerce Analytics to access your eCommerce dashboard, where you can view your Shopware 6 eCommerce data, analyze your revenue, product, and retention performances.
    woocommerce_ecommerce-attribute-sync_en-us.png

➡️ To learn more about the eCommerce dashboard, check our dedicated section in the Help Center.

woocommerce_ecommerce-dashboard_en-us.png

Step 2: Track customer activity in real time

When you sync your Shopware 6 contacts to Brevo, the plugin automatically installs the Brevo tracker on your store. This lets you track customer activity, like product views, cart updates, and purchases in real time, and sync this data to Brevo.

The following events are tracked and sent to Brevo:

  • Page
    A visitor views any page on your Shopware 6 store.
  • Identify
    A contact is identified by their email address (e.g. during sign-up or checkout).
  • eCommerce events
    • cart_updated: A contact adds a product to their cart.
    • order_completed: A contact completes a purchase.

You can view all tracked events under Automations > Logs > Event logs in Brevo.

➡️ To learn more, check our dedicated articles:

Step 3: (Optional) Use your Shopware 6 eCommerce data and customer activity information in Brevo

Use your synced Shopware 6 eCommerce data and real-time customer activity directly within Brevo to:

Send product alerts (back-in-stock)

✅ Plan availability
Product alerts are only available on Professional and Enterprise plans. For more information, check our pricing page or talk to one of our sales experts.

Automatically send email alerts to your customers when their favorite out-of-stock item becomes available again. 

Activating the product alerts feature will automatically add an email input field and a Notify me of new stock button to each out-of-stock product page on your online store. Your visitors can enter their email and click the button to be notified when the product is back in stock. ⬇️

shopware_product-alert-button_en-us.png

❗️ Important
The email field and Notify me of new stock button are currently not customizable, including the text, design, and layout.

To activate the product alerts option:

  1. From your Brevo account, create a back-in-stock automation to automatically send an email to interested visitors when their awaited product is back in stock.
  2. From the plugin settings, click Product Alerts.
  3. Activate the Allow customers to subscribe to alerts for out-of-stock products.
    shopware_product-alert-activate-option_en-us.png
  4. Click Save. An email field and Notify me button will automatically be added to your out-of-stock products on your online store.

Congratulations! 🎉 The product alerts (back-in-stock) feature has been activated. Website visitors and customers who subscribed to back-in-stock alerts will automatically receive an email when the product becomes available again.

Send transactional emails

💡 Good to know
To send transactional emails for your Shopware store via Brevo SMTP, make sure your SMTP account has been activated.

To send transactional emails for your Shopware store via Brevo SMTP:

  1. From the plugin settings, click SMTP for transactional mailing.
  2. Activate the Use Brevo to send your store's transactional emails option.
  3. In the Choose your sender drop-down list, choose the email address you want to use to send your transactional emails for your Shopware store.
  4. Click Save.

Track your visitors' actions

Behavior tracking enables you to track, through Brevo, all of the pages on your website visited by your contacts. Once identified, contacts will be automatically added on Brevo and can be entered into your Marketing Automation workflows.

If you are using our latest version of the Shopware plugin (v3.1.0), behavior tracking is automatically enabled when synchronizing your orders with Brevo. 

Create marketing automations

automation.png

With Automations, create automated workflows and automatically send welcome or abandoned cart messages to your Shopware 6 customers. To learn more about Automations, check our dedicated articles.

Auto-populate product blocks in your email designs

When designing your emails with the email editor, you can easily and automatically populate your product blocks with the product information displayed on your Shopware 6 store:

prestashop_auto-populate-product-block_EN-US.gif

Your product information is automatically filled in the Product block such as its image, name, description, price, and also URL. The URL is automatically added to the product image and button. To learn more about the Product block, check our dedicated article Insert a Product block in the Drag & Drop Editor.

Chat with your customers

Use Brevo Conversations and install a chat widget on your Shopware 6 store to connect with your leads and customers in real-time. You can also connect your other communication channels, such as Facebook Messenger or Instagram Direct.

Conversations offers additional features such as chatbot, targeted chats, mobile apps, and saved replies to help you sell more online.

➡️ To learn more, check our dedicated article With Conversations, change the way you communicate with your customers.

 

conversations_chat-example_EN-US (1).gif

Uninstall the plugin

  1. In your Shopware admin, go to Extensions > My extensions.
  2. Find Brevo: eMail & Online Marketing Platform in the list.
  3. Click the three-dot icon and select Uninstall.
    shopware_uninstall-plugin_en-us.png
  4. Confirm the uninstallation.
❗️ Important

Uninstalling the Brevo plugin does not delete any Shopware 6 data already synced to Brevo. However:

  • New or updated data from Shopware 6 will no longer sync to Brevo.
  • Emails, order tracking, automations, and visitor tracking will stop.

Troubleshoot the plugin

Review the following common issues and their solutions:

Revenue showing zero or incorrect values in the eCommerce dashboard

Order statuses not selected during initial setup

When you first enable eCommerce sync, you must select which order statuses represent completed transactions. If you select too few statuses, some orders are excluded from the sync.

Solution: In your plugin settings under Ecommerce Attribute Synchronization, verify that you have selected all order statuses that represent completed or billable transactions (for example, "Completed," "Paid," "Shipped"). After changing your selection, only new orders with those statuses will sync. Historical orders that did not match your original selection will not be added retroactively.

Orders with promotions or vouchers not syncing

Orders that include promotion codes or vouchers may fail to sync if the plugin cannot match line items correctly.

Solution: Verify that your promotions and vouchers are configured correctly in Shopware. Ensure that all line items in the order have valid product references. If the issue persists, contact Shopware support for assistance with your promotion configuration.

Contacts being unexpectedly blocklisted after sync

Non-newsletter subscribers being blocklisted in Shopware 6.7

In Shopware 6.7, the plugin syncs only newsletter-subscribed customers as subscribed contacts. Regular store customers (those who made purchases but did not explicitly subscribe to your newsletter) are synced as blocklisted to comply with privacy regulations.

Solution: This is the expected behavior in Shopware 6.7. If you want to market to your regular customers, you must first invite them to subscribe to your newsletter through an email, pop-up, or checkout form. Once they subscribe, they will be re-synced as subscribed contacts in Brevo. Alternatively, in the plugin settings, enable Enable syncing of customers in addition to newsletter subscribers to import all customers as subscribed (ensure you have proper consent to do this in compliance with email regulations).

Product sync failures with variants or promotions

Products with multiple variants not syncing

Products with many variants or complex variant configurations may fail to sync if the plugin encounters issues matching variant data across sales channels.

Solution: Simplify your product variant setup in Shopware if possible. Ensure that all variants have clear product identifiers and are assigned to your active sales channels. If you have many variants (50+), consider breaking them into separate products. If the issue continues, contact Shopware support for optimization guidance.

Shopware 6.7 compatibility issues with product sync

Shopware 6.7 introduced changes to the product database layer that can cause compatibility issues with certain product configurations.

Solution: Ensure you are running the latest version of the Brevo plugin compatible with Shopware 6.7 (v5.1.0 or later). Update your plugin if needed. If product sync continues to fail, verify that your product data structure is compatible with Shopware 6.7 by contacting Shopware support.

Missing contacts or orders during sync

Incomplete data sync when using multiple sales channels

The Shopware 6 plugin only syncs data from the currently connected sales channel(s). If your Shopware store has multiple sales channels and only one is connected to Brevo, customers and orders from other sales channels will not be synced.

Example: If your Shopware account has 600k+ customers across multiple sales channels but only one channel is connected to Brevo, you may only see 130k-200k contacts synced (representing only the data from the connected channel).

Solution:

  • To sync all data from all sales channels: Disconnect the single-channel connection and create a new connection for "All Sales Channels". This will combine all customer and order data in a single Brevo account.
  • To route each sales channel to a separate Brevo account: The plugin supports per-sales-channel configuration. Navigate to the Brevo Extension in Shopware, select each sales channel individually, and click "Connect to Brevo". For each channel, you can click "Use a different account" to log into and connect a different Brevo account.

After changing your sales channel connection settings, trigger a full re-sync of your contacts and orders to ensure all data is properly transferred.

Orders with promotions or vouchers not syncing

Orders that include only promotional or voucher line items (where product_id = NULL) may fail to sync because the plugin requires valid product references for order synchronization.

Solution: Verify that your orders contain at least one line item with a valid product reference. Orders composed entirely of promotional adjustments without linked products cannot be synced with the current plugin version.

⏭️ What's next?

🤔 Have a question?

If you have a question, feel free to contact our support team by creating a ticket from your account. If you don't have an account yet, you can contact us here.

If you’re looking for help with a project using Brevo, we can match you with the right certified Brevo Agency partner.

💬 Was this article helpful?

9 out of 20 found this helpful