Troubleshooting & debugging Klaviyo Toolkit Issues

0 December 9, 2024


If you’re experiencing issues with the Klaviyo Toolkit for WooCommerce, follow the steps below to troubleshoot and resolve common problems.

1. Ensure Your Klaviyo Toolkit License is Activated

The plugin will not function properly without an active license. Here’s how to verify:

  1. Navigate to the Klaviyo Toolkit settings in your WordPress dashboard.
  2. Go to the License tab.
  3. Confirm that your license key is entered and marked as active.

If the license is not active:

  • Re-enter your license key and click Activate.
  • Ensure the key matches the one provided at purchase.
  • If activation fails, ensure your subscription is valid or contact support.

2. Verify Your Klaviyo API Keys Are Configured Correctly

API keys are essential for syncing your WooCommerce store with Klaviyo. To check:

  1. Navigate to the Klaviyo Toolkit settings in WordPress.
  2. Go to the API Keys section.
  3. Ensure the public and private API keys are entered correctly.
    • Public Key (Site ID): Used for tracking customer behavior.
    • Private API Key: Used for data syncing.

If you are unsure where to find your keys:

  • Log in to your Klaviyo account.
  • Go to Account > Settings > API Keys to copy your keys.
  • Test the connection by saving your settings and performing a sync (if available).

3. Ensure Proper Events Are Enabled

The Klaviyo Toolkit allows you to track various customer events. To ensure the correct events are enabled:

  1. Navigate to the Settings tab in the plugin.
  2. Check that relevant events (e.g., Viewed Page, WC Subscription Created, etc) are toggled on.

If an event is not working:

  • Ensure the corresponding functionality is active in your WooCommerce store.
  • Check your event settings to confirm there are no configuration issues.

4. Check the Klaviyo Developer Tools Log

The Klaviyo Developer Tools logs can help you identify if data from the plugin is reaching Klaviyo:

  1. Log in to your Klaviyo account.
  2. Navigate to Integrations > Developers > Developer Tools.
  3. Use the Activity Feed to view incoming requests from your plugin.
  4. Look for events triggered by your website (e.g., Viewed Page, WC Subscription Created, etc).
  5. Check for errors or failed requests.

Common issues:

  • No Requests Detected: Verify your API keys and event settings in the plugin.
  • Errors Logged: Review the error details for potential causes (e.g., API rate limits, misconfigured data).

Additional Tips

  • Enable Logging: Check the plugin settings for a logging option. When enabled, any errors or significant issues encountered by the plugin will be logged using WooCommerce’s built-in logging functionality and are available under WooCommerce > Status > Logs . Look for log files with the name prefix “klaviyo-toolkit”.
  • Update Your Plugin: Ensure you are running the latest version of Klaviyo Toolkit to avoid bugs and compatibility issues.
  • Check Compatibility: Verify that your WooCommerce and WordPress versions are compatible with the plugin.