One-Click Preference Apply Links

Let subscribers update email topics and/or frequency with a single click from a Klaviyo email—no form fill-out required. The link opens Last Chance, saves the preferences automatically, and shows a confirmation banner.

Overview

One-click preference links append query parameters to Klaviyo’s {% manage_preferences_link %}. When a subscriber clicks the link:

  1. Klaviyo routes them through your manage preferences consent / hosted page
  2. Last Chance validates the session and applies the topic and/or frequency values from the URL
  3. The subscriber lands on your Last Chance page with a success, partial, or failure banner
  4. Analytics records dedicated one-click events (separate from in-page preference saves)

This is different from:

FeatureWhat it does
Manage preferences (standard)Opens the preferences screen; subscriber chooses options manually
One-click preference applySaves specific topic/frequency values from the link itself
One-click unsubscribe (Gmail/Yahoo headers)Inbox-level opt-out via List-Unsubscribe—unrelated to this feature

Use one-click apply for campaign CTAs such as “Only send me sales emails,” “Switch me to weekly,” or “Yes, send me new product updates.”

Prerequisites

Before you use one-click links:

  • ✅ Topics and/or frequencies configured under Settings → User preferences (only active options can be applied)
  • ✅ Klaviyo connected, and your manage preferences consent page uses a Last Chance hosted redirect — see Klaviyo Preference Center Setup
  • ✅ Email templates use {% manage_preferences_link %} (URL-only tag) for custom HTML buttons and links — see Klaviyo email links & consent

Unsubscribe hosted page setup alone is not enough if manage-preferences clicks still hit Klaviyo’s default preference page. Wire the preference-center hosted page so one-click apply links reach Last Chance.

Combined snippet builder

  1. Go to Settings → User preferences
  2. Open the One-click preference apply links card (shown above the Topics / Frequencies tabs)
  3. Select one or more topics, choose merge mode, and optionally pick a frequency
  4. Copy the generated Liquid URL (starts with {% manage_preferences_link %}?...)
  5. Paste it into a Klaviyo email button Link address or custom HTML href

Per-topic / per-frequency copy buttons

On the Topics and Frequencies tabs, each active option has a link icon:

  • Frequency — copies a one-click link that sets that frequency
  • Topic — choose Add to existing topics (merge) or Set only this topic (replace)

Query parameters

ParameterPurposeExample
applyTopicsOne or more topic slugs (comma-separated)applyTopics=sales_and_discounts or applyTopics=foo,bar
applyTopicModeHow topics combine with existing saved topicsmerge (default) or replace
applyFrequencySingle frequency slug (always replaces existing)applyFrequency=weekly

Topic modes

  • merge (default) — Adds the link’s topics to whatever the subscriber already has saved. If they have no saved topics yet, the link’s topics become their full set.
  • replace — Sets topics to exactly what is in the link (removes other previously saved topics).

Invalid applyTopicMode values (anything other than merge or replace) skip topic apply. A valid applyFrequency in the same URL still applies. Subscribers see a partial or failed banner explaining that topics could not be applied.

entry=preferences is optional

One-click apply works without entry=preferences. Use entry=preferences only when you also want subscribers to land on the preferences screen instead of the default initial page. Apply params and preferences entry are independent.

HTML examples

<a href="{% manage_preferences_link %}?applyTopics=sales_and_discounts">
  Yes, send me sales &amp; discounts
</a>

<a href="{% manage_preferences_link %}?applyTopics=sales_and_discounts&applyTopicMode=replace">
  Only send me sales &amp; discounts
</a>

<a href="{% manage_preferences_link %}?applyFrequency=weekly"> Switch me to weekly emails </a>

<a
  href="{% manage_preferences_link %}?applyTopics=sales_and_discounts&applyFrequency=days_7&applyTopicMode=merge"
>
  Sales emails, once a week
</a>

Topic and frequency slugs must match your team’s configured values in Settings → User preferences. Prefer copying snippets from the dashboard so slugs stay correct when you rename or reorder options.

What subscribers see

After a successful apply, Last Chance shows a fixed confirmation banner near the top of the page (for example, “Preferences updated”) with a short summary of what changed. Status variants:

StatusMeaning
SuccessAll requested topic and/or frequency values were applied
PartialSome values applied; others were invalid or skipped (e.g. unknown topic slug, invalid topic mode)
FailedNothing could be applied

Success banners auto-dismiss after a few seconds; subscribers can dismiss any banner manually. Preferences are saved to the Klaviyo profile (email_topics, email_frequency) the same way as an in-page save.

Analytics

One-click applies are tracked separately from preference form saves:

EventWhen it fires
ACTION_ONE_CLICK_SAVED_TOPICSTopics were saved via a one-click link
ACTION_ONE_CLICK_SAVED_FREQUENCYFrequency was saved via a one-click link

In-page saves still use ACTION_SAVED_TOPICS / ACTION_SAVED_FREQUENCY. Klaviyo also receives matching metric events (for example, Last Chance: One-Click Saved Frequency) so you can trigger flows from one-click updates.

Best practices

  • Use clear CTA copy that matches the preference being applied (“Get weekly emails,” not a generic “Update preferences”).
  • Prefer merge for “add me to this topic” CTAs; use replace when the email is asking for a single exclusive interest.
  • Keep exclusion segments up to date so campaigns respect the new preferences — see User Preferences.
  • Test with a real Klaviyo send (or preview that goes through the consent page) so the hosted redirect and apply params both run.
  • Do not put one-click apply params on unsubscribe links ({% unsubscribe_link %}). Use manage-preferences links only.

Troubleshooting

IssueWhat to check
Link opens Klaviyo’s default preference pagePreference-center hosted page not assigned in Klaviyo consent settings
Banner says preferences failed / nothing appliedSlugs don’t match active topic/frequency values; option may be inactive
Topics skipped but frequency appliedInvalid applyTopicMode, or topic slugs not in your allowlist
Lands on initial page (expected)One-click apply does not require entry=preferences; add it only if you want the preferences screen
No analytics eventConfirm the click reached Last Chance (source=klaviyo) and the apply succeeded

For support: support@yourlastchance.app