Use Recharge Quick Action URLs in a Klaviyo campaign button

Recharge Quick Action URLs let customers complete actions directly from an email, such as opening the customer portal or reactivating a subscription.

This guide explains how to include Recharge Quick Action URLs in Klaviyo campaigns.

Before you start

• Klaviyo's standard Button block doesn't support Recharge Quick Action URLs. To use Quick Action URLs, you must create the button using a Custom HTML block.

• Recharge recommends working with a Klaviyo or Recharge implementation partner if you need assistance implementing custom email templates.

Step 1 - Add a Custom HTML block

1. Open your Klaviyo campaign or flow.
2. Edit the email where you want to add the Recharge Quick Action.
3. Add a Custom HTML block to the email.
4. Paste your custom HTML into the block instead of using Klaviyo's standard Button block.

Step 2 - Add the Recharge Quick Action URL

Insert your Recharge Quick Action URL inside a styled <a> tag.

For example, to direct customers to their Recharge customer portal:

<p style="margin:0 0 10px 0;">
Manage subscriptions in your customer portal.
</p>

<a href="https://[STORENAME].myshopify.com/tools/recurring/quick_actions/{{ person.rc_customer_hash }}/process?action=view_portal_page&page=subscriptions"
   style="display:inline-block;padding:12px 20px;background:#2A6949;color:#ffffff;text-decoration:none;border-radius:5px;font-weight:600;">
   View the customer portal
</a>

Recharge replaces the Quick Action variables when the email is sent.

Step 3 - Support customers with multiple subscriptions (optional)

Some Quick Actions can apply to multiple subscriptions, such as reactivating cancelled subscriptions.

In these cases, place the button inside a {% for %} loop so Klaviyo generates one button for each eligible subscription.

Example:

<p style="margin:0 0 10px 0;">
Come back to us and reactivate your subscription!
</p>

{% with activeSubs=person.rc_all_subscriptions|dictfilter:"status == CANCELLED" %}
{% with prepaidSubs=activeSubs|dictfilter:"is_prepaid == 0" %}
{% for sub in prepaidSubs|slice:"0:2" %}

<p style="margin:0 0 10px 0;">
Reactivate <strong>{{ sub.product_title }}</strong>
</p>

<a href="https://[STORENAME].myshopify.com/tools/recurring/quick_actions/{{ person.rc_customer_hash }}/process?action=reactivate&subscription_id={{ sub.subscription_id }}"
style="display:inline-block;padding:12px 20px;background:#2A6949;color:#ffffff;text-decoration:none;border-radius:5px;font-weight:600;">
Reactivate this subscription
</a>

<br><br>

{% endfor %}
{% endwith %}
{% endwith %}

Step 4 - Test your email

Klaviyo's preview doesn't support Recharge Quick Action URLs and may display blank content.

Instead:

1. Send a test email.
2. Open the email.
3. Click each Quick Action button.
4. Confirm the customer is taken to the expected Recharge experience.

See How to test a Recharge Quick Action URL included in a Klaviyo flow for additional testing guidance.

Considerations

Consider the following: