Skip to main content

Troubleshooting Your Klaviyo Integration

Resolve common issues related to list syncing, SMS delivery, and discount code properties between Alia and Klaviyo.

Written by Rojen M Reji
Updated this week

Subscription and List Management

If you notice that subscribers are not appearing in your Klaviyo account as expected, the issue usually stems from list settings or incorrect mapping within the Alia dashboard.

Single vs. Double Opt-in

By default, many Klaviyo lists are set to Double Opt-in. This means a user must click a confirmation link in their email before they are added to your list. If you see "missing" subscribers, they may simply have not confirmed their subscription yet.

  • Check your Klaviyo List settings under Settings > Consent of your list.
    ​


    ​

  • Switch to Single Opt-in if you want users to be added immediately after submitting the Alia popup.

Connecting to the Wrong Lists

Ensure that your Alia popup is pointed toward the correct Klaviyo List ID. It is common to accidentally sync a "Newsletter" popup to a "Transactional" or "SMS" list by mistake. You can verify this in the Integrations tab of your Alia popup editor.

πŸ’‘ Always perform a test submission using a fresh email address to ensure the contact flows into the specific Klaviyo list you've designated.


SMS Marketing Issues

SMS marketing requires specific configurations within Klaviyo. If your texts aren't sending or users aren't being subscribed, check the following:

  1. SMS Setup & Verification: Ensure you have fully completed the SMS setup in Klaviyo. Your sending number must be verified by Klaviyo before any messages can be dispatched.

  2. Incorrect Regions: Klaviyo SMS is region-specific. If you are trying to collect SMS subscribers in a country that you haven't enabled in your Klaviyo SMS settings, the subscription will fail.

  3. Conflicting SMS Providers: If you use a different service for SMS (like Postscript or Attentive) but find that Klaviyo is also sending texts, it means you still have Klaviyo SMS enabled and paid for. You must explicitly disable SMS within Klaviyo to stop these overlapping messages.


Resolving Discount Code Issues (alia_offer)

Alia passes a unique property called alia_offer to Klaviyo so you can display the user's specific discount code in your follow-up emails. If this code is missing or appearing as blank, follow these steps:

Include Property on the Submit Button

A common mistake is only displaying the discount code on the Alia Confirmation Screen. For Klaviyo to "see" the code and include it in an automated flow, the alia_offer property must be passed at the moment the user clicks the Email Submit button.

  • In the Alia editor, select your Email Input/Submit button.

  • Ensure the the reward property is set when customers submit their email so the data is sent to Klaviyo immediately.

Set a Backup Code in Klaviyo

In your Klaviyo email templates, you should always use a "fallback" or backup code. This ensures that if for any reason the property is missing, the customer still receives a valid code.

Use the following syntax in your Klaviyo email: {{ person|lookup:'alia_offer'|default:'WELCOME10' }} (replace 'WELCOME10' with your actual fallback code).

Did this answer your question?