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

Before integrating, make sure:

• You’ve logged in to the Klaviyo account you wish to integrate.

Download and install the extension

You can install via of one of two methods: via Composer, or via downloading our extension from Github and then uploading to Shopware. 

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.20.2? Run the command with the following extension version:

composer require klaviyo/shopware-klaviyo:1.14.3

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

composer require klaviyo/shopware-klaviyo:2.16.3

Are you using a Shopware version 6.6.0.0 or above? Run the command with the following extension version:

composer require klaviyo/shopware-klaviyo:3.3.3

Install via upload

1. Find Klaviyo's free extension at these links and click the Download button:
   
   • Using a Shopware version between 6.4.4.0 and 6.4.20.2? Download Klaviyo extension version 1.14.3.
   • Using a Shopware version between 6.5.0.0 and 6.5.8.10? Download Klaviyo extension version 2.16.3.
   • Using Shopware version 6.6.0.0 or above? Download Klaviyo extension version 3.2.2.
2. Log in to your Shopware admin for the store you wish to integrate.
3. Click Extensions > My extensions.
4. Click Upload extension.
   
5. Select the Klaviyo extension from your files.
6. Once the extension appears on your extension list, click Install.
   
7. 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 visitors who do not accept Klaviyo cookies will not be tracked by Klaviyo, nor will they be able to view Klaviyo forms. 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 CMP
     If this option is selected, consent management will be implemented via Usercentrics CMP. If you wish to select Usercentrics CMP, 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. 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. Give the key a name, 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 Done. Then, copy your public API key from the page.
   6. Paste the public API key in Shopware in the corresponding box.
7. Next, pick a Klaviyo list from the dropdown for profiles who subscribe via a Shopware form to be added to.
   
8. Select an identifier to use for Back in Stock variant field mapping. You should use the identifier that matches the one you use in your catalog.
9. Toggle on all the metrics you want to sync from Shopware to Klaviyo.
   
10. 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.
    
11. Under Snippet names, you’ll find a reference for how to refer to different Back in Stock components in HTML. You can choose to customize them within your site code.
    
12. Custom Field Mapping: Here, you’ll see custom fields you’ve set up in Shopware (with the technical name in gray). Any field assigned to the Customer object can be synced to Klaviyo. 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.
    
13. When you are finished, click Save. 
14. To run a sync of historical events, click Synchronize historical events at the top of the page. 
15. To run a sync of existing subscribers, click Synchronize subscribers at the top of the page. 

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. Note that only site visitors who accept Klaviyo cookies will be able to see Klaviyo sign-up forms. 

How to contact support

The Klaviyo Shopware 6 integration is supported by Klaviyo through Overdose Digital. 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

• How to sync a custom catalog feed to Klaviyo
• Shopware 6 data reference