How to target a specific subscription in a Klaviyo Quick Action campaign

  • Updated on Dec 3, 2025
  • 1 minute(s) read
  • Migration Team
  • K
 Prev Next

Sometimes, you’ll want to send a Quick Action (like a product swap) for a specific subscription—not just the next billing or most recently paused one. This guide walks you through how to create and use a custom Skio profile property in Klaviyo to target the exact subscription ID you need.

When should I use a custom subscription ID in a Quick Action?

Skio's default quick action links target dynamic values like:

  • skio_nextBillingActiveSubscriptionId

  • skio_lastPausedSubscriptionId

  • skio_lastCancelledSubscriptionId

These work well for general cases—but if a customer has multiple subscriptions, they might not target the right one.

Example:
If you're running a campaign to get subscribers of Apple Soda to switch to Orange Soda, targeting the next billing subscription ID might not work—because the next billing subscription could be something else entirely (like Lemon Soda).

To solve this, you’ll create a custom profile property with the correct subscription ID for each subscriber.

How to set up a complex Quick Action

Step 1: Export subscriber emails and subscription IDs

Use Segments or the GraphQL API in Skio to export the list of subscribers you want to target.

Create a CSV file with these two columns:

  • email — the subscriber's email address (from storefrontUserEmail)

  • skio_adhocQuickActionData — the subscription ID you want the quick action to target

Step 2: Upload the list to Klaviyo

  1. Open Klaviyo and create a new List.

  2. Import your CSV file with the email and skio_adhocQuickActionData fields.

  3. Klaviyo will map this data to each profile and store the custom property.

Step 3: Set up the quick action email

  1. Create a new Campaign in Klaviyo targeting the list you just uploaded.

  2. Use Skio’s quick action link format and replace the default subscription ID variable with your custom one.

https://yourstorename.myshopify.com/a/account/quick-action-v3?stackId=STACK_ID&subscriptionId={{ person.skio_nextBillingActiveSubscriptionId|default:'' }}

Example:

https://yourstorename.myshopify.com/a/account/quick-action-v3?stackId=STACK_ID&subscriptionId={{ person.skio_adhocQuickActionData|default:'' }}

Use this approach when:

  • You’re targeting a specific subscription across customers.

  • The default subscription ID properties aren’t accurate for your use case.

  • You want more control over your campaign logic in Klaviyo.

This technique gives you flexibility in segmentation and personalization—helping ensure that your quick actions are relevant and effective.

Related articles