How to Customize a Campaign Flow if the Email Already Exists in Klaviyo

What You'll Learn in This Article:

• How to check whether a submitted email already exists in Klaviyo before the form submits
• How to show an error or send returning subscribers to a different page
• Which metadata keys to set, and where
• How to test the extension and fix common setup issues

The Klaviyo – Email Lookup extension checks whether a submitted email address already exists in Klaviyo. If it does, the campaign either shows an error message or sends the visitor to a different page, and the form is not submitted. If the email is new, the form submits normally.

The extension never blocks a visitor because of a technical problem. If the lookup fails, takes longer than 8 seconds, or can't run, the form submits normally.

To use the extension, you need a connected Klaviyo integration in your Digioh account.

Install the Extension

1. Click your account name in the top right corner and select Extensions.
2. Find Klaviyo – Email Lookup and click Install.
3. Click Publish to Your Site to activate the extension. Installing takes effect on the next publish.

Connect the Extension to Klaviyo

The extension needs the ID of your Klaviyo connection.

1. In the top navigation, click Integrations, then select Integrations. Find your Klaviyo connection (for example, Primary Klaviyo Connection) and note the ID shown on its card, such as ID 77513. You can click the copy icon next to the ID to copy it.
2. Click your account name in the top right corner and select Account Metadata.
3. Add the key klaviyo_lookup_integration_id with your Klaviyo connection ID as the value.

Campaign Metadata Keys

In the campaign editor, go to Settings > Campaign Settings, turn on Campaign Metadata, and use the + button to add a row for each key you need.

If both klaviyo_email_lookup_error_message and klaviyo_profile_exists_change_page are set, the change page is used and the error message is ignored.

Email Field Names

The value of klaviyo_email_lookup_field depends on which page the email field is on:

• Main Page: email
• Extra pages: the page name, an underscore, then email, such as ep1_email or ep2_email
• Thank You Page: thx_email

Show the Error in Your Own Text Element (Optional)

By default, the error appears in the campaign's built-in error display. To show it in a text element you've placed in your design instead:

1. Add a text element where you want the error to appear.
2. In the element's settings, add element metadata with the key klaviyo_email_error_position and the value true.
3. In the element's Extra CSS Styles (not Wrapper CSS), add display: none; so the element is hidden until it's needed.

When an existing email is submitted, the extension puts the error message in this element and shows it. The element is hidden again at the start of the next attempt. If the element isn't a text element, or the value isn't true, the extension uses the built-in error display instead.

How It Works

1. When the visitor leaves the email field, the extension starts the Klaviyo lookup early, so the answer is usually ready by the time they click submit.
2. When the form is submitted, the extension holds it and shows a loading indicator until the lookup finishes.
3. If the email exists in Klaviyo, the visitor sees the error message or is sent to your change page. The form is not submitted.
4. If the email is new, the form submits normally.

The form also submits normally if the email field is empty, the lookup fails or takes longer than 8 seconds, or the connection ID isn't set. A submission is only blocked when Klaviyo confirms the email already exists.

If you also use Digioh Passport for Klaviyo on the campaign, the extension automatically waits to send the visitor's identity to Klaviyo until the lookup finishes. No setup is needed.

Common Setups

• Show an error on the same page: set klaviyo_email_lookup_field = email and klaviyo_email_lookup_error_message = This email is already registered.
• Send returning subscribers to a different page: set klaviyo_email_lookup_field = email and klaviyo_profile_exists_change_page = ep1, then build your "You're already subscribed" message on (EP1).
• Email collected on an extra page: set klaviyo_email_lookup_field = ep2_email (use your page number). Everything else is the same.

Troubleshooting

Turn on klaviyo_lookup_debug = true and open the notification panel to see each step of the lookup.

Running into an issue or have a question? Reach out to our support team at support@digioh.com.