Installation & activation instructions
⚠️ If you already have our older “Tribe – Klaviyo WooCommerce Subscription Events” plugin installed and active, you must deactivate it before proceeding.
- Download the plugin
- From within your WP admin, go to Plugins > “Add New “
3. Click the “Upload plugin” button, select the plugin to upload, install and activate.
- Navigate to the plugin settings page under the “Klaviyo Toolkit” menu item.
- Activate your license on the “license” tab.
- Configure your Klaviyo public API key (you can copy/paste it from the Klaviyo official plugin) in the plugin settings page.
ℹ️ If you’re moving from our old plugin to the new plugin, please continue here.
- Configure any events you’d like to start tracking.
- Once the events have triggered (ie. someone does something on your site to trigger the event), you’ll be able to view these new events under the “Dashboard > Activity Feed” section within Klaviyo. You can then create your flows and segments based off these new events.
ℹ️ These events sometimes can take time to populate. If you’ve configured everything, have had new subscriptions triggered but still aren’t seeing any events after 24 hours, please contact success@madebytribe.com for help.
Instructions if you’re using the legacy “TRIBE WooCommerce Subscription Events for Klaviyo” plugin
The following will allow you to now use the new plugin, without affecting your existing flows.
- Follow instructions 1-6 above.
- Enable the “Legacy subscription events” option within the plugin settings.
- Disable the legacy “TRIBE WooCommerce Subscription Events for Klaviyo” plugin
🚨 IMPORTANT: We recommend recreating your flows that are currently using the legacy events, and changing the trigger to use the new “WC Subscription Created” and “WC Subscription Status Changed” events. You can do this easily by duplicating flows and using the new triggers. Be sure to test everything before going live.
ℹ️ Learn more about the Legacy Subscription Events here.
Events Overview
Enable “Viewed Page” Event
Turning this event on will trigger a new “viewed page” event within Klaviyo every time someone views a page on your site.
The event includes:
- PageID = The ID of the page
- PageName = The title of the page
- URL = The URL of the page
Enable “Viewed Product Category” Event
Turning this event on will trigger a new “Viewed Product Category” event within Klaviyo every time someone views a product category on your site.
The event includes:
- ImageURL = The URL of the category featured image
- ProductCategoryID = The ID of the category
- ProductCategoryName = The name of the category
- URL = The URL of the category page
Enable “Viewed Post” Event
Turning this event on will trigger a new “Viewed Post” event within Klaviyo every time someone views a specific blog post on your site.
This event includes:
- ImageURL = The URL of the post featured image
- PostCategory = The parent category of the post
- PostID = The ID of the post
- PostName = The title of the post
- URL = The URL of the post
Enable “Searched Site” Event
Turning this event on will trigger a new “Searched Site” event within Klaviyo every time someone searches on your site.
This event includes:
- ReturnedResults = The number of results returned for this search query
- SearchTerm = The term that was searched
- SearchURL = The URL of the search results page
Enable “Added To Cart” Event
Turning this event on will trigger a new “Added To Cart” event within Klaviyo every time a logged in user adds a product to their cart. This event will not trigger for users who are not logged in.
The event includes:
- ProductName = Name of product
- ProductID = Price of product
- ProductURL = URL of the product
- ImageURL = URL for to featured image of the product
- ProductCategories = Which categories the product belongs to
- ProductVariationID = The variation product ID if this is a variable subscription product
- Value = Cost of the product
Enabled “WC Subscription Created” Event
⚠️ Requires the WooCommerce Subscriptions plugin
Turning this event on will trigger a new “WC Subscription Created” event within Klaviyo every time a new WooCommerce Subscription has been ordered.
This event includes:
WC Subscription Created Value = The total amount of the subscription
PlanID = The subscription ID
PlanInterval = The subscription interval
PlanName = The subscription product name
PlanTrial = If this plan has a trial period configured (true or false)
PlanTrialEndDate = The trial end date
PlanVariationID = The variation product ID if this is a variable subscription product
Enabled “WC Subscription Renewal” Event
⚠️ Requires the WooCommerce Subscriptions plugin
Turning this event on will trigger a new “WC Subscription Renewal” event within Klaviyo every time a WooCommerce Subscription status has been renewed.
This event includes:
- PlanID = The plan ID of the subscription
- PlanName = The name of the subscription plan
- PlanValue = The renewal amount
- PlanRenewalStatus: The status of the plan after renewal (Success, Fail)
Enabled “WC Subscription Status Changed” Event
⚠️ Requires the WooCommerce Subscriptions plugin
Turning this event on will trigger a new “WC Subscription Status Changed” event within Klaviyo every time a WooCommerce Subscription status has been changed.
This event includes:
PlanID = The plan ID of the subscription
PlanName = The name of the subscription product
PlanStatus = The current status of the subscription (active, on-hold, pending-cancellation, cancelled, expired)
PlanValue = The total monthly amount of the subscription
ℹ️ Note: On every subscription renewal, the WooCommerce subscription plugin will set the subscription status to “on-hold” temporarily while it attempts to charge the customer. If this charge is successful, it will change the status back to “active”. If it fails, it will keep it “on-hold”. This can cause any flows that you create to trigger on the “on-hold” status when they are not actually on hold. To work around this, you’ll need to add a flow filter as follows:
Enable Legacy Subscription Events
⚠️ Requires the WooCommerce Subscriptions plugin
ℹ️ Note: This is a legacy event that will eventually become phased out. It’s recommended you use the “WC Subscription Created” event and “WC Subscription Status Change” event moving forward.
Turning this event on will trigger two new events within Klaviyo:
- Subscribed To Plan – This event will trigger anytime there is a new subscription.
- Cancelled Plan – This event will trigger anytime someone cancels their plan.
Add images to WordPress RSS feeds
Turning this option on will add your featured post images to your WordPress RSS feeds. This will allow you to create a custom data feed within Klaviyo, for your blog posts and then include those blog posts into your flows and campaigns.
How to set up a campaign to automatically pull your latest posts
- Turn on the “Add images to WordPress RSS feeds” option.
2. Head over to https://www.klaviyo.com/feeds and click the “Add Web Feed” button:
3. Create a name, select your content type as “XML” and fill your feed URL. It should be “https://www.yourdomain.com/feed”.
4. Create a new campaign and open the email content editor.
5. Select the data feed you just created to use in the email
6. Add a new “Table” block to your email
7. Edit your table block and make sure you only have 2 columns
8. Click the “Rows” tab, then the “Dynamic” tab, then select the “Data Source” tab.
- Enter the following into the “Row Collection” field:
feeds.**NAME_OF_YOUR_FEED_GOES_HERE**.rss.channel.item|slice:':3' - Enter the following into the “Row Alias” field:
item - Click the “Column 1” tab, then click the “Source” button and add the following:
<img src="{{ item.image }}" /> - Click the “Column 2” tab and click the “Source” button. Add the following:
<h4>{{ item.title }}</h4> <br /> <a href="{{ item.link }}">View Post</a> - Save your content and you’re done! The email will now pull posts from your WordPress post feed.
Sending an abandoned cart email with the new “Added to Cart” flow.
The purpose of this flow is to trigger an abandoned cart email after someone has added to cart, rather than after someone has reached checkout (the standard Klaviyo method).
The benefit of this flow:
- You can trigger an email to someone if they’ve added to cart but never made it to checkout for the default Klaviyo abandoned cart to kick in.
Drawbacks of this flow:
- This flow is setup to only trigger after adding a single product to cart and will only show that first product in the flow. If they add more than one product, those products will not show in their emails. You could set it to allow multiple emails after each product is added to cart, but we’d advise against it as it could appear “spammy”.
- The user would need to be logged in order for this flow to work. At this point in the purchase funnel, if they aren’t logged in we won’t know the person’s email address and thus can’t send out emails to them.
Instructions:
- Duplicate the standard Klaviyo abandoned cart flow. Set the trigger as “when someone Added to Cart”
ℹ️ Note: there has to be an event recorded in Klaviyo (someone needed to have added to cart already) in order for this trigger event to be available.
2. Change the flow filters to show as:
3. Edit the content of your first email.
4. Edit the table block shown in your email.
5. Click “Rows” > “Static” > “Row1” > “Column 1” > “Image” and then click “replace image”
6. Edit the image URL to use:
event.ImageUrl
7. For image “Alt Text” use:
**{{ event.Produc**tName }}
For image “Link” use:
{{ event.ProductUrl }}
8. Next click “Rows” > “Static” > “Row1” > “Column 2” and then click the “Source” button.
9. Replace the contents with the following:
<h3><a href="{{ event.ProductUrl }}">{{ event.ProductName }}</a></h3>
<p>${{ event.Value|floatformat:2 }}</p>
10. Save the block and and save the email.
11. Preview the email to see if everything populated correctly. You should see the product image, product name and price.
12. Duplicate this for subsequent emails in your flow.