How to connect your subscriptions provider to Customer Hub
Learn how to display subscription details on orders in Customer Hub by connecting Recharge, Skio, Ordergroove, or Shopify order data.
Customer Hub for Shopify currently supports standard storefronts and Shopify Headless. For WooCommerce, navigate to https://help.klaviyo.com/hc/en-us/articles/47792369863451
Before you begin
- Make sure Customer Hub is enabled in your Klaviyo account.
- Subscription details require access to paid Customer Hub features, through a paid plan or an active trial.
- If you’re connecting a supported subscription app (Recharge, Skio, or Ordergroove):
- Ensure the Recharge app, Skio app, or Ordergroove app is set up and active on your Shopify store.
- Ensure the app is integrated with Klaviyo.
- If your subscription provider (Recharge, Skio, or Ordergroove) lets shoppers log in with a one-time code instead of a username and password, you can use Klaviyo One Time Password (OTP) for a similar Customer Hub login experience. Changing shopper login is optional and is not required to connect your subscription provider. See Match your shopper login experience below before changing this setting.
- If you’re using Shopify order data, no extra setup is needed.
How subscription information displays in Customer Hub
When customers log in to their account on your Shopify site and open the Customer Hub drawer, they can view recent orders on the Orders tab. By connecting a subscriptions provider, you can show subscription details next to each applicable product in an order, making it easy for customers to identify which products are part of a subscription versus standalone purchases.
The subscriptions setting is off by default. If neither a subscription app nor Shopify order data are connected, no subscription information will appear in Customer Hub.
Subscription details appear differently, depending on which connection you have enabled:
Supported subscription apps (Recharge, Skio, Ordergroove):
- Products purchased as part of a subscription display a badge with the subscription name (e.g., "Monthly") next to those items.
- A Manage subscription link lets customers view or manage their subscription when a subscription management link is available for that customer.
Shopify order data:
- Products purchased as part of a subscription display a badge with the subscription name next to those items.
- There is no button or option to manage subscriptions.
For products purchased as a one-time purchase, no subscription badge or subscription management link is shown. If an order contains both subscription and non-subscription products, only the subscription items display these details.
Connect your subscription provider
- In Klaviyo, go to Website > Customer Hub in the main navigation.
- Select Extensions.
- Under Subscriptions, select your provider from the Subscriptions provider dropdown:
- Recharge
- Skio
- Shopify order data
- Ordergroove
If you use Recharge, Skio, or Ordergroove, the provider’s API key field is optional. A private API key is used for subscription changes, such as editing or cancellation; you do not need to enter one just to save the provider selection.
- Click Save.
Once Customer Hub is live on your site, it will use your selected option to display subscription details next to applicable products in your customers’ orders.
Match your shopper login experience
Many subscription providers, including Recharge and Skio, let shoppers manage their subscription by logging in with a one-time code sent to their email. By default, Customer Hub uses your Shopify login. Under Shopper login, this option is labeled Shopify for standard Shopify storefronts and Shopify Customer Account API for headless Shopify storefronts.
Before changing your shopper login:
- Without Shopify Multipass, Klaviyo OTP signs shoppers into Customer Hub only. If shoppers also need native Shopify account pages, such as order history outside Customer Hub or saved payment methods, keep Shopify login or configure Multipass for a Shopify Plus store that supports it.
- Customer Hub can automatically redirect supported Shopify account links to the Hub. Check your storefront’s account links after changing login methods, and update any custom links that should open Customer Hub. Add
data-k-hub-ignoreonly to links that should keep opening the native Shopify account experience.
If you choose to use Klaviyo One Time Password (OTP), follow these steps:
- In Klaviyo, go to Website > Customer Hub.
- Select Settings.
- Under Shopper login, choose Klaviyo One Time Password (OTP).
- Enter a Store display name and a valid Reply to email address. The reply address cannot use a gmail.com or klaviyo.com domain.
- If you use Shopify Plus with Multipass, enter your Multipass API key to also sign shoppers into Shopify. Otherwise, leave this optional field blank.
- Click Save.
With Klaviyo OTP enabled, shoppers log in to Customer Hub with a one-time code sent to their email, matching the passwordless experience offered by subscription providers.
Optional: adding a content block for subscriptions
Like with all integrations that write profile data into Klaviyo, you can use content blocks to surface dynamic information. Note that for some content blocks, such as the template we provide for Recharge, there is no default link set. You must set the link for the content block and link it to your subscription landing page. Until you set this link, while the content block can display data like active subscription count, clicking the content block will not do anything because the link is not set.