Shopify App Integration Guide

This guide walks you through integrating the Wunderkind Platform with your Shopify store using the Wunderkind Shopify App. The app handles tasks like installing Wunderkind tags and pixels and setting up website tracking, making it easy to get started with Wunderkind's Onsite, Email, and Text products.

Completing these steps early will help you onboard faster. Installing and configuring the Shopify App will not trigger any email sends, so there is no risk to your store.

Note: This guide covers the full set of features within the Wunderkind Shopify App. If you only need Checkout Extensibility support, please checkout our Shopify App: Support for Checkout Extensibility guide here.

Table of Contents

• What Is the Wunderkind Shopify App?
• Before You Begin: Eligibility and Requirements
• Step 1: Install the Wunderkind Shopify App
• Step 2: Create Your Wunderkind Account
• Step 3: Enable the Wunderkind Tag
• Step 4: Enable Feature Toggles
• Step 5: Connect to Klaviyo (Klaviyo Integration Clients)
• Excluding Products from Wunderkind Campaigns
• Frequently Asked Questions

What Is the Wunderkind Shopify App?

The Wunderkind Shopify App makes it easy to set up Wunderkind's Onsite, Email, and Text products by handling tasks like installing Wunderkind tags and pixels and setting up website tracking.

Before You Begin: Eligibility and Requirements

Before installing, confirm that your store meets the following requirements. For any questions about eligibility, reach out to your Wunderkind contact.

Step 1: Install the Wunderkind Shopify App

1. Log in to your Shopify store.
2. Navigate to the Wunderkind App listing at https://apps.shopify.com/wunderkind 
3. Click Install to add the app to your store.
   1. If you see "meet with the Wunderkind team" instead of install, reach out to your Wunderkind contact to approve your install on the backend.
4. On the confirmation screen that appears, click Install again to confirm.

Step 2: Create Your Wunderkind Account

After installation, you will need to create your Wunderkind Platform account.

1. On the Welcome screen that appears in the Wunderkind App, click the Click here or log in button. This will direct you to the Wunderkind Platform.
2. A new tab will open with the Wunderkind Platform login page. Since this is your first time, click Sign Up.
3. Enter your Email Address and choose a Password.
4. Check the boxes to agree to the Terms of Service and Privacy Policy.
5. Click Continue.
6. You will see a QR code for two-factor authentication. Use an authenticator app (such as Google Authenticator) to scan this code.
7. Enter the One-Time Code provided by the authenticator app.
8. Click Continue.
9. Back in your Shopify app, you will see a prompt to Finish your Wunderkind setup. Click this to open the Wunderkind Platform in a new tab. You may need to authenticate one more time.

Step 3: Enable the Wunderkind Tag

1. From the home page of the Wunderkind App in Shopify, click "Enable Wunderkind Tag". This will take you into the App Embeds section of your Shopify theme and turn on the tag.
2. The Shopify App UI will display a list of unpublished themes and the status of the tag (app block extension) within each theme. This lets you see the status before publishing and make sure the tag is placed when developing and changing themes.
3. Press "Save" in the upper right-hand corner of the screen.

You have successfully placed your tag! ✅

Tip: If you change your Shopify theme in the future, you will need to re-enable the Wunderkind Tag in the new theme before making the switch.

Step 4: Enable Feature Toggles

1. In Shopify, click "Apps" in the left-hand navigation bar and select "Wunderkind". The Wunderkind App homepage will load.
2. Click "Settings" on the left-hand side navigation bar under "Wunderkind" (not your Shopify settings).
3. Under Product Features, make sure the following toggles are enabled:

You have now successfully installed the Wunderkind Shopify App! 🎉

For clients using Klaviyo Integrations: Continue with Steps 5–7 below to complete your onboarding. If you are not a Klaviyo integration client, your setup is complete — your Wunderkind team will take it from here.

Step 5: Connect to Klaviyo (Klaviyo Integration Clients)

1. In the Wunderkind Platform, select Apps & Integrations → Your Integrations in the left navigation.
2. Find Klaviyo and click Connect. 
3. Review the permissions, then click Connect. 
4. In a separate browser tab, open Klaviyo and log in to your account. 
5. In the bottom-left corner, click your account name, then navigate to Settings → API Keys. 
6. Under Private API Keys, click Create Private API Key. Name it "Wunderkind," select Full Access Key, click Create, and copy the key. 
7. Return to the Wunderkind Platform and paste your Klaviyo API key into the input field in the modal.
8. Click Verify API Key to confirm the connection.

Congrats! Your work here is done. Your Wunderkind team will complete the setup from here. 🎉

Reach out to your Wunderkind contact with any questions.

Excluding Products from Wunderkind Campaigns

If specific collections or products should be excluded from Wunderkind sends, please reach out to your Wunderkind contact first, as doing so may impact performance.

To Exclude Collections

1. Go to the "Settings" page of the Wunderkind App in Shopify.
2. Select the collections you want to exclude from Wunderkind sends.

To Exclude Individual Products

1. Navigate to the "Products" section within your Shopify store and click into the product you want to exclude.
2. In the top right-hand side of the product page, click "More Actions".
3. Click Wunderkind Product Attributes.
4. Click "Exclude this product from Wunderkind Marketing".
5. Click "Save".

Frequently Asked Questions

What is "Finish your Wunderkind setup (self-service beta)"?

You may notice a beta link within the Shopify app. Do not worry about using that link — it does not add anything to the Wunderkind experience. Wunderkind is constantly iterating on new interfaces and experiences. While you will not use the sign-up process behind the link, future clients will benefit from the new developments that come from this kind of experimentation.

Why does the Shopify app ask for "read_markets" permissions?

Wunderkind uses the Shopify Markets permissions to support a few upcoming features. When Wunderkind is running across multiple geographies (e.g., country-specific websites with distinct website IDs), the integration with Shopify Markets allows Wunderkind to continue delivering geographically specific experiences and ensures that conversions are appropriately assigned to the correct websites.

If Wunderkind is not supporting multiple website IDs across your Shopify store, there is no need to grant these additional permissions. However, you may need to go back and enable them at a later date to start using new features. Your Wunderkind contact can confirm if this applies to you.

What happens if I change my Shopify theme?

The Wunderkind Tag must be enabled in each theme. If you switch to a new theme, follow the instructions in Step 3 above to re-enable the tag in the new theme before making the switch.
 

Need help? Reach out to your Wunderkind contact at any point during the setup process. Your Wunderkind team is here to support you every step of the way.