Set up Klaviyo integration

With the Klaviyo integration, Shoporama sends newsletter sign-ups, customer profile creations, and events from the store and your orders to Klaviyo. This allows you to build automated email flows and segments in Klaviyo based on what your customers do in the store.

Setup consists of four steps: find two keys in Klaviyo, enter them in Shoporama, choose which lists to subscribe customers to, and enable tracking and events. You must have a Klaviyo account.

Find your keys in Klaviyo

Shoporama requires two keys from Klaviyo. The public key is used for Klaviyo’s tracking code on the pages of your store. The private key is used to retrieve your lists, subscribe customers, and send events to Klaviyo.

Klaviyo’s interface is in English, so the buttons and menus below are listed using Klaviyo’s own names. These names may change if Klaviyo updates its design.

Open API Keys

1. Log in to Klaviyo and click your account name in the bottom-left corner.
2. Select “Settings” from the drop-down menu.
3. Select API keys from the submenu on the General tab.

If you’re logged into Klaviyo, you can also go directly to API keys in Klaviyo. On the Mailing List page in Shoporama, the same link appears below the key fields as “Open API keys” in Klaviyo once you’ve selected Klaviyo as your provider.

Copy the public key

At the top of the page, under “Public API Key / site ID,” the public key is listed in the “Public API Key” column next to your company name. It is six characters long. Copy it so you have it ready for the “Public Key” field in Shoporama.

Create a private key

1. Click Create Private API Key under Private API Keys.
2. Give the key a name in the “Private API Key Name” field—for example, “Shoporama”—so you can tell later what it’s used for.
3. Select “Full Access Key ” under “Select Access Level.”
4. Click Create in the top-right corner.
5. Copy the new private key. It starts with pk_.

The private key grants full access to your Klaviyo account, so only share it where it’s needed.

Paste the keys into Shoporama

1. Go to Integrations, Mailing List.
2. Select Klaviyo in the Provider field under Newsletter Provider, and click Save. The fields for Klaviyo will then appear.
3. Enter the public key in Public Key and the private key in Private Key under Connection.
4. Click Save.
5. Shoporama will now retrieve your lists from Klaviyo and display them under Lists. Select your lists as described below.
6. Enable “Automatically insert tracking code into your theme” and “Use events” under “Tracking and Events,” then click Save. If your theme has Klaviyo built-in—such as Alaska—leave the tracking code disabled (see below).

If the lists don’t appear and the message “Enter both keys and save—Shoporama will retrieve your lists from Klaviyo” is displayed , check that both keys have been entered and saved, and that you have at least one list in Klaviyo. If the private key is incorrect, a red error box will appear above the “Connect” card. The public key isn’t checked here, so copy it carefully.

Select which lists customers will be added to

Under “Lists,” select which lists in Klaviyo your customers should be added to. The drop-down menus show the lists you have in Klaviyo, so create the lists in Klaviyo first (under “Audience”). There are two options. The first one is required; the second is optional. If you use both, they must point to two different lists.

Sign up newsletter subscribers for this list

This is where customers are added who check the box to receive your newsletter themselves: at checkout, on a sign-up form, or on the “Create Profile” page. The checkbox on the “Create Profile” page is available in the built-in themes that include customer accounts. Shoporama sends the customer’s email and name to the list.

If you do not select a list here, Shoporama cannot subscribe the newsletter recipients, and you will receive a notification below the clock at the top of the admin panel stating that a list ID is missing.

If you use Shoporama’s own newsletter—that is, select “Use Internal Newsletter List” under “Newsletter” > “Setup”—newsletter sign-ups will go there instead of to Klaviyo. The list for customers who create a profile works independently of that.

Subscribe customers who create a profile to this list

With this list, you can automatically keep a customer club list in Klaviyo up to date, for example, instead of manually exporting and importing customers. In Shoporama, the customer club typically consists of your customers with profiles—for example, if you use the loyalty program or customer groups. Customers are added to the list when they create a profile themselves:

• on the “Create Profile” page in the store
• at checkout, when they check the box to create a profile

Shoporama sends the customer’s email and name to Klaviyo in the background, typically within a minute. The customer doesn’t have to wait for this.

This only happens when the customer creates their own account. Customers you create in the admin panel, customers from an import or via Shoporama’s API, and colleagues invited by a company administrator in B2B are not added to the list.

The default is “None,” and in that case, nothing happens. If you select a list, it applies to new profiles from the moment you click Save. If you select the same list as for newsletter subscribers, Shoporama does not save your selection, and the field reverts to “None.”

Does the customer need to confirm their subscription?

For the newsletter subscriber list, this is controlled by the list settings within Klaviyo. If double opt-in is enabled for the list, Klaviyo sends a confirmation email, and the customer is added to the list only after they’ve confirmed. With single opt-in, the customer is added to the list immediately. At the bottom of the API Keys page in Klaviyo, you’ll also find Default Opt-In Settings, which apply to sign-ups via API keys such as Shoporama’s. Check this setting if customers aren’t receiving a confirmation email or are receiving one you didn’t expect. The “Respect double opt-in in Shoporama” setting does not change this behavior.

The list for customers who create a profile never sends a confirmation email. The customer is added directly to the list without changing their consent, so the list’s double opt-in is not used here.

Do you already have a customer club?

Customers who already have a profile won’t be added to the list automatically. You can add them by importing them once into Klaviyo: go to Customers, Registered Customers, click Download All Customers, and import the file into the list in Klaviyo. The file contains all your registered customers, including those you’ve created in the admin panel or imported, so remove any who shouldn’t be on the list before importing. The customers in the file haven’t been notified that they’ll be added to the list, so consider whether you’re allowed to send marketing messages to them. After that, Shoporama will keep the list updated with new profiles.

What gets transferred to Klaviyo?

Shoporama does not automatically send your entire customer database or catalog to Klaviyo. The following information is transferred:

• Customers: when they sign up for the newsletter and when they create a profile, if you’ve selected a list for that. Includes email and name.
• Visits and orders: as events. Visits require the tracking code, and orders require “Use Events.” Klaviyo links the events to the customer’s profile via their email address. See which events are included below.
• Products: via a product feed, which you can import as a catalog into Klaviyo and use for recommendations in your emails. Turn on “Enable Klaviyo feed? ” under “Webshop,” “General” in the “Feeds” section. The feed is located at dinshop.dk/my-klaviyo-feed.xml with your own domain. The exact address is displayed when you check the box, and it changes if you protect the feed with a feed key. Additionally, the “Viewed Product” event includes the product’s data.

What events does Shoporama send to Klaviyo?

Klaviyo builds flows and segments based on events, which are called “metrics” in Klaviyo. Shoporama sends two types: events from the store while the customer is browsing, and events from orders. Each type has its own contact in the “Tracking and Events” card on the “Mailing List” page.

Store events

Sent when “Automatically insert tracking code into your theme” is enabled:

• Viewed Product: The customer views a product page. Includes the product’s name, price, brand, categories, image, and link.
• Viewed Category: The customer views a category page. Includes the category’s name, ID, image, and link. The homepage does not count.
• Added to Cart: The customer adds an item to the cart.
• Started Checkout: The customer is in the cart or checkout. Includes the items, total amount, and a link back to the cart.

Once the customer has entered their email address during checkout, Klaviyo links the visit to the customer’s profile. This allows the events to be used in flows for customers who are not logged in.

Events from orders

Sent when “Use Events ” is enabled. This requires that you have entered your private key:

• Placed Order: An order has been created.
• Ordered Product: one event for each item in the order.
• Paid: The order has been paid.
• Status: The order’s status changes. The status is included in the name, e.g., Status: Sent.
• Add Label and Remove Label: An order label is added or removed, e.g., Add Label: VIP.
• Added to Cart: This is also sent from here once the customer has provided their email address.

Flows You Can Set Up

With the Klaviyo integration, you can set up automated email flows such as:

• Welcome flow: a greeting for new customers
• Abandoned Cart: a reminder for customers who didn’t complete their purchase
• Abandoned browsing: a reminder for customers who viewed products or categories without buying
• Post-purchase: follow-up after a purchase
• Win-back: Reactivating inactive customers

Frequently Asked Questions

I’ve already set up Klaviyo. Do I need to do anything?

No. Your keys and your newsletter list work just as before. The field is now called “Subscribe newsletter recipients to this list.” If you want to use the new list for customers who create a profile, select it and click “Save.”

I’ve saved both keys, but I can’t select any lists. What’s wrong?

Check that the private key starts with pk_ and that you haven’t mixed up the two keys. If the key has been deleted in Klaviyo, you’ll need to create a new one. The drop-down list shows only lists, not segments.

Does the private key really need full access?

We recommend the Full Access Key because that’s the one the integration was tested with. With a more restricted key, you might not be able to retrieve the lists, or customers might not be subscribed.

What if the customer both creates a profile and checks the box for the newsletter?

In that case, the customer will be added to both lists: the newsletter list because they checked the box, and the profile list because they created a profile. In Klaviyo, the customer is still a single profile that appears on both lists.

How do I test whether the customer club list is working?

Create a profile in your own store using an email address you have access to that isn’t already registered as a customer in the store. Wait a minute. The sign-up process happens in the background. Then check the list in Klaviyo. If the profile doesn’t appear, please email us at support@shoporama.dk.

Can I start a welcome flow for the customer club in Klaviyo?

Yes. In Klaviyo, a flow can be triggered when someone is added to a specific list, so you can use the profile list as the trigger. The sign-up only sends the customer’s email and name, so it’s the list that tells Klaviyo who’s in the customer club.

I have multiple stores and one Klaviyo account. How do I set this up?

You set up the integration separately for each store under Integrations, Mailing List. You can use the same keys for all stores and choose which lists each store should use. If you want to be able to distinguish between customers in Klaviyo, give each store its own list.

Need help? Contact us at support@shoporama.dk.