Getting started with Shopware

You will learn

Learn how to integrate with Shopware 6 in order to bring site activity, order, catalog, and subscriber data into Klaviyo.

Before you begin

Please note the following:

• Before integrating, make sure you're logged in to the Klaviyo account you want to integrate.
• The Shopware 6 integration is supported by Klaviyo through a third party. If you need to contact support, see the section below on how to do so.

Add the plugin to your Shopware account

1. Go to the Klaviyo plugin page in the Shopware Store.
2. Log in when prompted, then select Add to cart.
3. Proceed to checkout and complete your order.
4. Once the order is confirmed, click the option to go to your Shopware Account.
5. In your Shopware Account, navigate to Merchant > Shops.
6. Select the shop you purchased the plugin for.
7. Under the Licenses section, locate the Klaviyo plugin and open the plugin details page.

Download and install the extension

You can install using 1 of 2 methods: via Composer or via downloading our extension. After selecting an installation method, you should use that same method each time you update.

Install via Composer

When installing via Composer, you'll need to specify the Klaviyo extension version; not all extensions work for all Shopware versions.

Are you using a Shopware version between 6.4.4.0 and 6.4.XX.XX? Run the command with the following extension version:

composer require klaviyo/shopware-klaviyo:1.24.0

Are you using a Shopware version between 6.5.0.0 and 6.5.XX.XX? Run the command with the following extension version:

composer require klaviyo/shopware-klaviyo:2.24.0

Are you using a Shopware version between 6.6.0.0 and 6.6.XX.XX? Run the command with the following extension version:

composer require klaviyo/shopware-klaviyo:3.8.0

Are you using a Shopware version between 6.7.0.0 and 6.7.XX.XX? Run the command with the following extension version:

composer require klaviyo/shopware-klaviyo:4.4.0

After Composer finishes, run bin/console plugin:refresh from your Shopware root directory. Then open Extensions > My extensions in your Shopware admin. Install and activate the Klaviyo extension before continuing to Configure the extension in Shopware.

Install via upload

1. Open the plugin details page and download the latest available version (or any required version):
   
   • Using a Shopware version between 6.4.4.0 and 6.4.XX.XX? Download Klaviyo extension version 1.24.0.
   • Using a Shopware version between 6.5.0.0 and 6.5.XX.XX? Download Klaviyo extension version 2.24.0.
   • Using a Shopware version between 6.6.0.0 and 6.6.XX.XX? Download Klaviyo extension version 3.8.0.
   • Using a Shopware version between 6.7.0.0 and 6.7.XX.XX? Download Klaviyo extension version 4.4.0.
2. Log in to your Shopware admin for the store you wish to integrate.
3. Click Extensions > My extensions.
4. Click Upload extension and select the ZIP file you downloaded. You may see a warning message during the upload. Click Confirm to continue.
   

5. Once the extension appears on your extension list, click Install.
   

6. Toggle on the Klaviyo extension.
   

Configure the extension in Shopware

1. In your Shopware store admin, navigate to Settings and click the Extensions tab.
2. Select Klaviyo. You will be brought to the Klaviyo extension settings page.
3. Under Sales Channels, select the sales channel you wish to integrate with Klaviyo from the dropdown. Only integrate one sales channel with Klaviyo per Shopware store. You must also configure your settings for each sales channel individually.
4. Under Interaction settings, select the cookie consent tool you’d like to use with this integration. Note that when a cookie consent tool is selected, visitors must accept Klaviyo cookies before the onsite tracking script and Klaviyo forms can load. The cookie consent tool options are:
   • Nothing
     If this option is selected, Klaviyo has free access to store cookies.
   • Shopware Default
     If this option is selected, cookie management will be implemented via Shopware's default method, given that it's turned on. To turn it on, navigate to Settings > Shop > Basic information, find the Security and Privacy section, and then toggle on Use Default Cookie Notification.
   • CookieBot
     If this option is selected, cookie management will be implemented by CookieBot. If you wish to select CookieBot, you must already have it installed on your Shopware store.
   • Consent Manager
     If this option is selected, consent management will be implemented via Consent Manager. If you wish to select Consent Manager, you must already have it installed on your Shopware store.
   • Usercentrics
     If this option is selected, consent management will be implemented via Usercentrics. If you wish to select Usercentrics, you must already have it installed on your Shopware store.
5. If you do not use a cookie management tool (which already blocks Klaviyo’s script from loading) and want to speed up page load times, toggle on the setting Initialize Klaviyo After First Interaction With Page. This will enable the following behavior:
   • After the client starts interacting with the page, the Klaviyo scripts will be initialized.
   • On subsequent page transitions, the scripts will be initialized immediately.
     

6. Under General, turn on Enable Account for the selected sales channel.
7. To continue, obtain your public and private API keys from Klaviyo. To do this, open a new tab and log in to the Klaviyo account you want to integrate with Shopware.
   1. Click your account name in the lower left and select Settings.
   2. Select API keys.
   3. Click Create Private API Key. Name the key "Shopware Integration," then select Full Access Key and click Create. On the next page, click Copy Key.
   4. Paste the private API key into the corresponding setting within Shopware.
   5. Back in Klaviyo, click Close. Then, copy your public API key from the page.
   6. Paste the public API key in Shopware in the corresponding box.
8. Next, pick a Klaviyo list from the dropdown for profiles who subscribe via a Shopware form to be added to.
   

1. Under Product identification field mapping, select the identifier that matches the one you use in your catalog. This setting applies to product identifiers in events, including Back in Stock. The Klaviyo (XML) catalog template used below exports product numbers.
2. Toggle on all the metrics you want to sync from Shopware to Klaviyo.
   

3. If you choose to track Back in Stock, you can customize the text color and background of the Back in Stock pop-up opening button, pop-up close button, and subscribe button. Click the square, then use the selector to choose a color, or, if you have the hex color codes for your brand’s colors, paste it in the corresponding box.
   

4. Under Snippet names, you’ll find the Shopware snippets for Back in Stock text, such as button labels and the email field label. Use these names to find the text you want to customize in Shopware’s snippets.

5. Under Customer Custom Field Mapping, you’ll see the active custom fields assigned to customers in Shopware. To sync these custom fields to Klaviyo profiles, toggle the individual field to Active. Then, under Field Name, type the corresponding name you’d like the field to have in Klaviyo.

6. When you are finished, click Save.
7. To run a sync of historical events, click Synchronize historical events at the top of the page. Set optional From date and To date values to limit the sync, or leave both blank to sync all historical orders. Click Proceed to schedule the sync.
8. After the historical event sync finishes, click Synchronize subscribers at the top of the page to sync existing subscribers. If a confirmation appears, click Confirm after checking that the earlier sync has finished.

Sync your catalog feed

To complete your integration with Klaviyo, you must generate a feed of your product catalog, then sync it to Klaviyo. To generate the feed:

1. Log in to your Shopware store admin.
2. Click + next to Sales Channels to add a new channel.
3. Next to Product comparison, click Add Sales Channel.
4. Under Template, choose Klaviyo (XML).
5. Give the channel a name, such as Klaviyo Export.
6. Under Tax collection, select Line by line (horizontal) calculation.
7. Under Storefront Sales Channel:
   • Select the Storefront Sales Channel this catalog is for.
   • Select the Storefront domain.
   • Select the currency.
   • Select the language.
   • Select the Customer Group.
8. Under Product export:
   • Name the file (e.g., klaviyo.xml).
   • Select the encoding UTF-8.
   • Select the file format XML.
9. Leave Export variants as discrete products toggled off.
10. Select the interval: 1 day.
11. Leave Generate via scheduler toggled off.
12. Select your dynamic product group.
13. Under Status, toggle on Active.
14. Click Save in the upper right.
15. Scroll down and copy the Export URL, which you will use for the Klaviyo sync.
16. Now that the feed is generated, you must sync it to Klaviyo. Follow the instructions to sync a custom catalog feed to Klaviyo.

Data synced from Shopware

To learn all about the data synced from Shopware and how to access it in Klaviyo, read our Shopware data reference.

Klaviyo sign-up forms

You can add Klaviyo sign-up forms to your Shopware store in order to collect subscribers. If you selected a cookie consent tool in the extension, visitors must accept Klaviyo cookies before the forms can load.

Troubleshooting onsite tracking

If the Active on Site or Viewed Product metric appears in Klaviyo but isn't populating with data, work through the checks below.

1. Test with an identified visitor
   
   For a controlled test, log in to your Shopware storefront with a test customer account, accept Klaviyo cookies, and view a product page. Check that customer’s activity in Klaviyo. The plugin waits until Klaviyo identifies the visitor before sending Viewed Product events; accepting cookies alone does not identify a visitor.
2. Check your cookie consent
   
   In the extension’s Cookie Consent setting, select the tool installed on your store: Shopware Default, CookieBot, Consent Manager, or Usercentrics. Save the setting, accept Klaviyo cookies on your storefront, and reload a product page. If tracking still does not load, check whether the browser has the od-klaviyo-track-allow cookie. If it is missing after consent, check the connection between your consent tool and the extension. The extension handles supported consent events; you do not need to make the consent tool write this cookie manually.
3. Check that the product data is on your product pages
   
   View the page source of a product page and search for data-klaviyo-product-viewed-event-tracking-component. This hidden element carries the product data used for Viewed Product. If it is missing, first confirm that the extension is active and Enable Account is on for the correct sales channel, with your API keys and list saved. If those settings are correct, have your developer check that your custom theme preserves the plugin’s product-detail template. Reload the page and check for the element again.
4. Check the first-interaction setting
   
   Check Initialize Klaviyo After First Interaction With Page. If it is on, scroll on the storefront page, then check tracking again. The setting delays the script until the first interaction; subsequent page loads can initialize it immediately. To remove this delay, turn the setting off, save, and reload the page. The selected cookie consent tool must still allow Klaviyo to load.
5. Check for a JavaScript error on the page
   
   Open the developer console on a product page and look for errors affecting the Klaviyo script or product-tracking code. Have your developer resolve those errors, then reload and repeat the identified-visitor test. An unrelated JavaScript error does not by itself show that Klaviyo tracking has stopped.

How to contact support

The Klaviyo Shopware 6 integration is supported by Klaviyo through a third party. If you have questions about the integration and need support, you can contact integration-specific support by filling out our form.

If you need general support for Klaviyo-related questions, contact Klaviyo support.

Outcome

You’ve integrated Shopware 6 with Klaviyo to bring site activity, order, catalog, and subscriber data into Klaviyo. You can now start using Klaviyo for your owned marketing needs.

Additional resources