This is an official Klaviyo email marketing extension for Spree Commerce - the open-source eCommerce platform for Rails.

Once the Spree and Klaviyo integration is set up, Spree automatically tracks the following customer events happening on your store website and sends them to Klaviyo, so you could set up your desired email campaigns triggered by these events:

• Product view
• Product list view
• Product search
• Product added to cart
• Product removed from cart
• Checkout step view
• Checkout step complete
• Coupon entered/removed
• Coupon applied/denied
• Checkout email entered
• Newsletter subscription
• Unsubscribe from newsletter

These events populate the Audience → Profiles section in Klaviyo, where you can view each user’s tracked activity and properties. Lists used for newsletter subscriptions can be found in Audience → Lists & Segments.

1. Add this extension to your Gemfile with this line:

   bundle add spree_klaviyo

2. Run the install generator

   bundle exec rails g spree_klaviyo:install

3. Restart your server

If your server was running, restart it so that it can find the assets properly.

Please follow our setup guide how to setup Klaviyo with Spree Commerce.

1. Create a dummy app

   bundle update
   bundle exec rake test_app

2. Add your new code

3. Run tests

   bundle exec rspec

When testing your applications integration with this extension you may use it's factories. Simply add this require statement to your spec_helper:

require 'spree_klaviyo/factories'

bundle exec gem bump -p -t
bundle exec gem release

For more options please see gem-release README

If you'd like to contribute, please take a look at the instructions for installing dependencies and crafting a good pull request.

Copyright (c) 2025 Vendo Connect Inc., released under the AGPL 3.0 license.

Join our Slack to meet other 6k+ community members and get some support.

Contact us for enterprise support and custom development services. We offer:

• migrations and upgrades,
• delivering your Spree application,
• optimizing your Spree stack.