Skip to main content
Before installing and configuring the Voyado Shopware integration, confirm the following are in place.

​
Required products and access

  • Shopware 6.1.0 or higher
  • An active Voyado Engage licence with the Shopware app enabled
  • Access to the Shopware admin panel with plugin installation permissions
  • The Voyado Shopware plugin package
  • A product feed connected to Engage for each market locale (for example, sv-SE)
  • Engage email templates configured for back-in-stock and abandoned cart automations

​
Required credentials and configuration

The integration requires the following values during setup:
  • Store ID — generated in the Shopware admin after installing the plugin; must be sent to your Voyado team to complete configuration
Important: Store ID must be unique per environmentYour Store ID must be unique across all your Shopware environments (test, staging, and production). If environments share the same Store ID, data syncing to Voyado Engage can be corrupted or mixed between environments.This typically happens when a staging or test environment is created by cloning a production database, since Shopware stores the shop identifier in the database and both environments will inherit the same ID.To ensure each environment gets a unique Store ID after cloning:
  1. Update the APP_URL in the environment’s .env.local file to match the staging or test domain (for example, APP_URL=https://staging.my-shop.com).
  2. When you next open the Shopware admin, you’ll be prompted with a Domain change detected modal. Select Reinstall your apps to generate a new shop ID and re-register all app connections under the new domain.
  3. Reinstall the Voyado plugin in the new environment. A new Store ID will be generated.
  4. Send the new Store ID to your Voyado team so the environment can be configured separately in Engage.
For more details, see Shopware’s staging environment guide:https://developer.shopware.com/docs/guides/hosting/installation-updates/creating-a-staging-instance.html
The integration enforces consent before any data is collected. Your storefront must dispatch a voyadoConsentGranted browser event when a visitor accepts cookie consent, and a voyadoConsentRevoked event when consent is withdrawn. This is handled automatically when using Shopware’s built-in cookie banner. If you use a third-party CMP, confirm it can dispatch these events or that you can trigger them manually.
If your CMP cannot dispatch voyadoConsentGranted and voyadoConsentRevoked, tracking will not activate regardless of whether the plugin is installed correctly.

​
Customer responsibilities

  • Ensure cookie consent configuration is aligned with your privacy policy
  • Confirm that voyadoConsentGranted and voyadoConsentRevoked fire correctly in your consent setup
  • Decide whether to enable the personalised promotions widget (optional, controlled by a toggle in the plugin configuration)
  • Create the hasAccount custom contact attribute in Engage before syncing contacts (see Setting up)

​
Implementation partner responsibilities

  • Install the Voyado Shopware plugin and send the Store ID to the Voyado team
  • Verify shop ID and sales channel ID are correctly configured
  • Confirm consent events fire correctly in a test environment before go-live
  • Validate contact identification for both login-based and soft-identification flows
  • Confirm phone number validation is in place on all customer registration forms

​
Before you continue

Verify:
  • The Voyado Shopware plugin is installed and active
  • The Store ID has been shared with the Voyado team and configuration is confirmed
  • Cookie consent dispatches the correct browser events
  • The hasAccount attribute exists in Engage
  • A test Voyado contact is available to validate identification and tracking

Configuration

Good to know

Technical details