Getting started with Shopware 6

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
• You are using Shopware version 6.4 

Purchase the free extension

1. Head to Klaviyo’s extension on the Shopware store. Klaviyo’s extension is free; do not purchase one of the other extensions labeled as “Klaviyo.” These are not built by Klaviyo and charge for the extension.
   
2. Click Add to shopping cart, then select Proceed to checkout.
3. Log in to your Shopware store account (if you are not already logged in).
4. Complete the checkout process.

Install the extension

1. Log in to your Shopware admin for the store you wish to integrate.
2. Click Extensions, then select My extensions. You should see Klaviyo under Apps.
3. Click Install. The page will refresh.
4. 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. The Klaviyo integration supports cookie consent through Shopware’s default tool (Shopware Default) and through CookieBot. If you wish to select CookieBot, you must already have it installed on your Shopware store. Note that visitors who do not accept Klaviyo cookies will not be tracked by Klaviyo, nor will they be able to view Klaviyo forms.
   
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 for profiles who subscribe via a Shopware form to be added to. 
   1. In Klaviyo, navigate to Audience > Lists & segments.
   2. Copy the name of the list you want to sync subscribers to (e.g., “Newsletter”).
   3. Paste the name of the list in the corresponding box in Shopware.
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.
• Leave Export variants as discrete products toggled off.
• Select the interval: 1 day.
• Leave Generate via scheduler toggled off. 
• Select your dynamic product group.
9. Under Status, toggle on Active. 
10. Click Save in the upper right.
11. Scroll down and copy the Export URL, which you will use for the Klaviyo sync.
12. 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:
1. Log in to the Shopware store.
2. Under Merchant area, click Support.
3. In the upper right, select Request Support. 
4. Select your shop from the dropdown and click Next step.
5. Select Extension support and click Next step.
6. Select Klaviyo: Email & SMS Marketing from the extension dropdown and click Next step.
   
7. Fill out the form with the details of your support request, then click Next step.
8. Click Send request. 
9. Your support request will appear on the support overview page.
• 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