Connect Heatmap to Klaviyo to filter your analytics by Klaviyo campaign and send on-site behavior back to Klaviyo for segmentation and automation.
In this guide
Connect Klaviyo
Filter Analytics by a Klaviyo campaign
On-site events sent to Klaviyo
Disconnect Klaviyo
FAQs and troubleshooting
Overview
The Heatmap Klaviyo integration works in two directions:
DIRECTION | WHAT IT DOES | WHERE YOU USE IT |
Klaviyo → Heatmap | Filter Heatmap Analytics to see only visitors who came from a specific Klaviyo campaign. | Heatmap → Analytics → Filters |
Heatmap → Klaviyo | Send on-site events (such as add to cart or demo booked) to Klaviyo every 15 minutes. | Klaviyo → Analytics → Metrics, profiles, segments and flows |
Before you begin
You need access to your Heatmap dashboard at portal.heatmap.com.
You need a Klaviyo account you can sign in to and authorize the connection from.
The Heatmap tracking code should already be installed on the website you want to connect.
Tip: Connection is set up per website. If you manage more than one site in Heatmap, select the right one from the website dropdown before you connect.
Connect Klaviyo
Step 1: Log in to Heatmap
Go to portal.heatmap.com and sign in. You land on your dashboard.
Step 2: Select your website
In the left sidebar, open the website dropdown and select the site you want to connect.
Step 3: Open Integrations
In the profile section at the bottom of the left sidebar, click Settings, then open Integrations.
Step 4: Start the connection
Under Klaviyo, click Connect.
Step 5: Approve permissions in Klaviyo
You are taken to Klaviyo’s permission screen. Sign in if prompted, review the requested permissions, and click Allow.
What To Expect: Klaviyo may first show a notice that the app has not yet been reviewed. This is expected while the Heatmap app is going through Klaviyo’s marketplace review. Click Continue to proceed.
The integration is fully functional and has been tested end to end. The notice relates only to Klaviyo’s public listing status, not to how the integration works or how your data is handled.
Note: If you click Deny, you are returned to Heatmap with a message explaining that Heatmap was not given access. Nothing is connected. You can try again at any time by clicking Connect and choosing Allow.
Step 6: Confirm the connection
You are returned to the Integrations page. Klaviyo now shows as Connected for your site.
You are connected. Heatmap starts sending on-site events to Klaviyo automatically, and the Klaviyo filter is now available in Analytics.
Filter Analytics by a Klaviyo campaign
Use this to see how visitors from one specific Klaviyo campaign behave on your site.
Step 7: Open Analytics
In the left sidebar, click Analytics.
Step 8: Open the filters panel
Click Filters.
Step 9: Choose Klaviyo as the platform
Click Ads Platform, then select Klaviyo.
Step 10: Pick your account and campaign
Select the connected Klaviyo account, then select the campaign you want to filter by.
Step 11: Apply the filter
At the bottom of the panel, click Apply. Heatmap may ask whether to save the filter. Click Save filter to reuse it later, or Not now to continue without saving.
Analytics now shows only visitors from that Klaviyo campaign.
Tip: To go back to all traffic, open Filters again and clear the Klaviyo selection.
On-site events in Klaviyo
Once Klaviyo is connected, Heatmap sends your site’s on-site events to the connected Klaviyo account every 15 minutes. There is nothing to configure.
Which events are sent
The events depend on your site.
SITE TYPE | EXAMPLE EVENTS |
Marketing site | homepage_viewed, demo_booked |
Online store | add_to_cart, checkout_started |
Whose activity is sent
Events are sent only for visitors Klaviyo has already identified, for example:
Someone who clicked a link in a Klaviyo email
Someone who submitted a Klaviyo form
Anonymous visitors are not sent to Klaviyo.
How events appear in Klaviyo
WHERE | WHAT YOU SEE |
Metrics | Events appear under Analytics → Metrics with Heatmap as the source. |
Profiles | Events show in each visitor’s profile activity feed. |
Segments and flows | Events can be used as conditions in segments and as triggers for flows. |
Timing | Each event keeps the time the visitor actually took the action, even though events are delivered in 15-minute batches. |
Ideas for using Heatmap events
GOAL | HOW |
Follow up on high intent | Create a flow triggered by add_to_cart or checkout_started. |
Nurture demo requests | Create a segment of profiles with demo_booked and send a tailored sequence. |
Re-engage browsers | Create a segment of profiles who did an on-site event in the last 30 days but did not purchase. |
Disconnect Klaviyo
You can disconnect from either Heatmap or Klaviyo.
Step 12: Disconnect from Heatmap
Go to Settings, open Integrations, and under Klaviyo click the disconnect icon next to the Connected label.
In the Are you sure? prompt, click Disconnect to confirm.
A Success message confirms that the Klaviyo integration has been disconnected. Heatmap revokes its access, so the app no longer appears in your Klaviyo account, and Heatmap stops sending events.
Step 13: Disconnect from Klaviyo
Sign in to Klaviyo and click Integrations in the left sidebar. Under My apps, click the three-dot menu on the Heatmap row, then choose Remove integration.
In the Remove integration prompt, click Remove integration to confirm.
Klaviyo confirms with the message Heatmap was removed from integrations.
Heatmap detects the change at its next sync, within 15 minutes. Klaviyo then shows as Disconnected on the Integrations page, and Heatmap stops sending events.
Note: Events already sent to Klaviyo stay in your Klaviyo account. Disconnecting only stops new events from being sent.
Quick reference
ITEM | DETAIL |
Connect from | Settings → Integrations → Klaviyo → Connect |
Filter location | Analytics → Filters → Ads Platform → Klaviyo |
Event send frequency | Every 15 minutes |
Who is sent | Only visitors Klaviyo has already identified |
Where events appear | Klaviyo → Analytics → Metrics (source: Heatmap) and profile activity |
Disconnect detection | Within 15 minutes if removed in Klaviyo |
FAQs
Why don’t I see my events in Klaviyo yet?
Events are delivered every 15 minutes, so allow a little time. Also confirm that the visitor was already identified by Klaviyo, for example they arrived from a Klaviyo email or submitted a Klaviyo form. Heatmap does not send events for anonymous visitors.
Why don’t I see every visitor from my site in Klaviyo?
Heatmap only sends events for visitors Klaviyo already knows. It does not create new Klaviyo profiles from anonymous traffic.
Are the event times accurate?
Yes. Each event keeps the time the visitor actually took the action, not the time it was delivered to Klaviyo.
Can I send events from before I connected?
No. Events are sent after the integration is connected, so activity from before the connection will not appear in Klaviyo.
What events are sent for my site?
It depends on your site. A marketing site might send homepage_viewed and demo_booked, while a store might send add_to_cart and checkout_started. Check Analytics → Metrics in Klaviyo and look for Heatmap as the source.
Can I use Heatmap events to trigger flows?
Yes. Heatmap events can be used in segments and as flow triggers, just like other Klaviyo metrics.
I clicked Deny by mistake. What now?
Nothing is broken. Go to Settings → Integrations, click Connect under Klaviyo, and choose Allow.
Troubleshooting
PROBLEM | WHAT TO CHECK |
Klaviyo doesn’t show as Connected | Return to Settings → Integrations and confirm you selected the right website. If it says Disconnected, click Connect and choose Allow. |
Message that Heatmap wasn’t given access | You clicked Deny on Klaviyo’s permission screen. Click Connect again and choose Allow. |
Klaviyo missing from the Ads Platform filter | Confirm Klaviyo is connected for the website you selected in the left sidebar. |
No campaigns appear in the filter | Make sure you selected the connected Klaviyo account first, then check the campaign list. |
Events aren’t appearing in Klaviyo | Wait 15 minutes, then check Analytics → Metrics for Heatmap as the source. Confirm the visitor has been identified by Klaviyo. |
Klaviyo suddenly shows Disconnected | Heatmap may have been removed from your Klaviyo account. Heatmap detects this within 15 minutes. Reconnect from Settings → Integrations. |
Still stuck? Contact Heatmap support at support@heatmap.com and include your website name and the time you last attempted to connect.