Install and setup the Shopware connector

Learn how to install, set up, and get started using the Shopware connector.


The Shopware connector enables you to synchronise all of your Shopware customers to Engagement Cloud. You can choose which of your Shopware data fields get mapped to your Engagement Cloud contact data fields, allowing you to synchronise your customers' order histories and use it for better campaign targeting. You can also enrol new customers and new subscribers into your programs.

Firstly, and before you can get going with any of the above, you'll need to install the connector.

Before you start

Things you need to know before you start:

  • If you have a store connected to another environment, such as a staging environment, you must disconnect it in Engagement Cloud and reconnect it to a production environment in Shopware.

Install the Shopware connector

To install the Shopware connector:

  1. Go to the Engagement Cloud Shopware page and download the plugin.
  2. In the Shopware admin, go to Configuration > Plugin Manager.
  3. Under Management, select Installed and then select + Upload plugin.
  4. In the window that appears, select Select to choose your downloaded zip and then select Upload plugin.
  5. Select Activate.
  6. Go to Marketing and select dotdigital Engagement Cloud. Engagement Cloud opens in a new browser window.
  7. Log into Engagement Cloud.
  8. You'll see the 'Almost there!' message, outlining the three final steps to complete:
    • Download the bridge zip file.
    • Copy and unzip the bridge file into your Shopware root folder.
    • Select Test connection to check it's working correctly.
      A message confirms a successful connection, and your store data will begin syncing very soon.
      If the connection is unsuccessful, you'll see an error message. In this case, you must go back over the steps and make sure everything is done correctly.commerce_flow_unable_to_connect.png

Working with your Shopware store settings

Once you've successfully installed the connector, you can start working with your general Shopware connector settings in Engagement Cloud. They're accessed by clicking on Shopware in the settings menu.


This takes you to the 'Store' tab, where you can access data synchronisation, contact synchronisation and program enrolment settings. You can also remove your Shopware connection completely if you wish.

Remember to click Save after making any changes.

Let's go through the sections.

Connected store

Store name: Your store's name is confirmed here.

Store URL: The URL for your store is confirmed here. Click on it if you want to open it in a new browser.

Data sync: If something has changed with one of your Shopware customers, such as they've unsubscribed from your store, then this is reflected in Engagement Cloud once synchronisation has taken place.

We attempt synchronisation five minutes after the last sync process finishes. Depending on the amount of data you're processing, the time each sync takes to complete might be between a few seconds to many hours.

You're able to turn data syncing On or Off, should you need to. You can also force an unscheduled sync by clicking Sync now.

Last sync: The date and time of the last sync is provided here.


Please send campaigns only to subscribers

Some of your customers may not have opted in to your marketing messages when they bought a product from your store.

To conform to international email spam laws and best email marketing practice, and to maintain a good sending reputation, please make sure that you send campaigns only to the 'Store subscribers' address book. These are the contacts to whom you have permission to send campaigns to.

Enforce double opt-in for new subscribers: If you select Yes, all new subscribers are sent a confirmation email. These subscribers are removed from your address books until they verify their double opt-in status.

If you select No, it gets overridden if you've selected 'Enforce double opt-in for all signups, including bulk uploads' in your regulatory settings.

Sync customers to: A dropdown allows you to choose the Engagement Cloud address book you'd like to sync your Shopware customers to. Alternatively, you don't have to choose an address book and your customers won't get synced at all.

Customers are the users that have an account in your store, including those who aren't opted into your marketing. We don't sync contacts passing orders as guest at the moment.

Sync subscribers to: This operates in a similar way as above.

The system prevents you from being able to sync customers and subscribers to the same address book, ensuring that they always remain separate.

Only contacts who are subscribers get synced into 'Store subscribers'. That is, only contacts who have opted in to receive your marketing emails when creating an account, or while checking out in your store, will be synced here.

Who are subscribers?

Subscribers are customers who opted in to receive your marketing emails either when they created an account or when they checked out a product in your store.


Enrol new customers to: A dropdown allows you to choose the Engagement Cloud program you'd like to enrol new Shopware customers on.

Enrol new subscribers to: Similarly, a dropdown allows you to choose the Engagement Cloud program you'd like to enrol new Shopware subscribers into.

Enrol customers on each new order to: Select the Engagement Cloud program on which you'd like to enrol your Shopware customers when they place a new order. 

Enrol customers on their first order to: A dropdown allows you to choose the Engagement Cloud program you'd like to enrol your Shopware customers on as soon as they place their first order.

Be careful who you enrol on automation programs

Some of your customers may not have opted in to your marketing messages when they bought a product from your store.

If any of your programs send messages to your contacts, make sure that you enrol only subscribers on those programs.

Please note, contacts can be re-enrolled into the program selected for Enrol new subscribers to if they are removed from the Sync subscribers to address book, and then become a subscriber in your store.

Store access

Click on Remove Shopware connection to disable the connector and remove the integration with immediate effect.

How synchronisation works

Automatic synchronisation of your Shopware customers' order histories and of your Shopware product catalogue requires Insight data and AccountInsight to be enabled on your account respectively. Speak to your account manager if you'd like to enable these.

Order synchronisation

Your Shopware customers' order histories will automatically synchronise upon installation. This data gets synced to your account's Insight data collections for contacts. You'll then be able to segment upon contact order data and target your customers more effectively.

Product synchronisation

All of your visible products in Shopware will also automatically synchronise upon installation. This data gets synced to your AccountInsight 'Catalog_Default' collection. You'll then be able to make use of EasyEditor's product block.

Recording consent for your contacts

Consent is an agreement between you and your contacts about your intentions with their personal data.

We let you to store this consent in a free Insight data collection called ConsentInsight.

You can capture consent for your contacts, using one of the following:

  • A signup form
  • An embeded form (surveys and forms)
  • The API
  • The manual in-app importer

Working with your field mapping settings

Clicking on the Field mapping tab will enable you to map the Shopware customer fields of your choice to corresponding Engagement Cloud contact data fields.


The customer fields for Shopware are (with data types in parentheses):

  • First name (text)
  • Last name (text)
  • Login (text)
  • Created date (date)
  • Birthday (date)
  • Billing address 1 (text)
  • Billing address 2 (text)
  • Billing phone (text)
  • Billing fax (text)
  • Billing city (text)
  • Billing postcode (text)
  • Billing state (text)
  • Billing region (text)
  • Billing country (text)
  • Billing company (text)
  • Shipping address 1 (text)
  • Shipping address 2 (text)
  • Shipping phone (text)
  • Shipping fax (text)
  • Shipping city (text)
  • Shipping postcode (text)
  • Shipping state (text)
  • Shipping region (text)
  • Shipping country (text)
  • Shipping company (text)

Click on the dropdown next to the Shopware customer field and select the Engagement Cloud contact data field that you wish to map and sync to.

Engagement Cloud's default contact data fields are automatically mapped to their equivalent Shopware customer field for you.

It's up to you which Shopware customer fields that you wish to synchronise. Leave them unmapped if you don't wish to sync that specific data to Engagement Cloud.

Click Save once you're happy with your mapping settings and begin syncing to these Engagement Cloud contact data fields.

If you no longer wish to sync data from a Shopware customer field, you can simply deselect the mapping here and click Save to update your mapping settings. The next time a sync runs, your Shopware data will no longer sync to this Engagement Cloud contact data field.

Did you find this article helpful?

Can we help?

Thanks for using Engagement Cloud. If you need more help or support, then contact our support team.