Back to Community
Home / Community / Plugin → Pinterest for woocommerce

Troubleshooting Pinterest for WooCommerce Tag Health and Event Errors

39 threads Sep 11, 2025 Plugin → Pinterest for woocommerce

Content

Many WooCommerce store owners using the Pinterest for WooCommerce plugin encounter a common yet frustrating issue: their Pinterest Tag Health shows as "Unhealthy" or "Limited Integrity" in the Pinterest Ads Manager. This often manifests as errors about missing events (like Checkout or Add to Cart) or incorrect event parameters (like Product ID, Value, or Currency). If you're seeing these warnings, you're not alone. This guide will walk you through the most common causes and their solutions, based on community-reported issues.

Why Do These Tag Health Errors Occur?

Pinterest's system automatically checks if the tracking events from your website match the product data in your catalog. The "Pinterest for WooCommerce" plugin is designed to send these events automatically. However, discrepancies can arise due to several factors:

  • Data Mismatch: The format of the Product ID sent in an event (e.g., Add to Cart) does not match the format used in your product catalog.
  • Missing Events: Critical conversion events, particularly the Checkout event, are not being detected by Pinterest.
  • Theme or Plugin Conflict: Your active theme or another plugin modifies standard WooCommerce pages or AJAX behavior, preventing the Pinterest tracking script from firing correctly.
  • Testing with Free Orders: Pinterest often does not count checkouts with a total value of $0.00 towards tag health.
  • Reporting Delay: There can be a significant delay (several hours or even days) between a real event occurring on your site and Pinterest's Tag Health dashboard updating to reflect it.

How to Troubleshoot and Fix Tag Health Issues

1. Verify Events with the Pinterest Tag Helper

Before making any changes, use the official Pinterest Tag Helper Chrome extension to see what's happening in real-time on your site.

  1. Install the extension and pin it to your Chrome toolbar.
  2. Navigate to your website and perform key actions: view a product, add a product to the cart, and complete a paid checkout.
  3. Click the extension icon to see a list of detected events and their parameters.

What to look for: Ensure the PageVisit, AddToCart, and Checkout events are firing. Crucially, check that each event includes the correct product_id parameter and that it matches the ID format in your catalog.

2. Perform a Conflict Test

If the Tag Helper shows missing or incorrect events, a conflict is likely. This is the most common root cause.

  1. On a Staging Site: It is highly recommended to perform these tests on a staging or development site to avoid disrupting your live store.
  2. Switch Themes: Temporarily switch to a default WordPress theme like Twenty Twenty-Four. Clear your cache and test the events again with the Tag Helper. If the events fire correctly, the issue lies with your theme. You will need to contact your theme's support for assistance, as they may need to ensure compatibility with WooCommerce's standard hooks.
  3. Disable Plugins: If the issue persists with a default theme, disable all plugins except for WooCommerce and Pinterest for WooCommerce. Test again. If the events work, re-enable your plugins one-by-one, testing after each, to identify the conflicting plugin. Common conflicts arise from:
    • Ajaxified cart plugins
    • Google Tag Manager (GTM) plugins that might modify tracking
    • Heavy caching or asset optimization plugins (see point 4 below)
    • Custom checkout field managers

3. Test with a Real, Paid Checkout

Pinterest's system may not register test orders or orders with a $0.00 value. To properly trigger and test the Checkout event:

  • Use a payment gateway in "test mode" (like Stripe or PayPal Sandbox) to simulate a real transaction.
  • Alternatively, use a simple payment method like "Bank Transfer" or "Check Payments" and create a real order with a value greater than $0.00.
  • Complete the purchase and wait at least 24-48 hours for Pinterest's system to process the event and update your Tag Health status.

4. Address Caching and Optimization Conflicts

Some caching and JavaScript optimization plugins (e.g., SiteGround Optimizer, WP Rocket) can interfere with the dynamically generated Pinterest tracking code. If you see issues or are advised by your host to exclude scripts:

  • You may need to exclude the Pinterest tracking script from JS combination/minification features in your optimization plugin. The exact handle is typically specific to the plugin, but you can often find it by looking for scripts containing "pinterest" in their URL.
  • Consider delaying the loading of the Pinterest tag until after user consent for cookies is given if required for GDPR compliance. This usually requires a separate GDPR compliance plugin.

5. Check Your Tax and Price Settings

If the value parameter in your events is flagged, it could be due to how prices are sent. The plugin typically uses the price format set in WooCommerce > Settings > Tax under "Display prices during cart and checkout". If you need prices sent inclusive of tax but your cart shows prices excluding tax, this can cause a mismatch. Unfortunately, the plugin does not currently have a separate setting for this, which may require a custom solution.

When to Seek Further Help

If you have performed all the steps above and Pinterest's Tag Health dashboard still shows errors after 48 hours, the issue may be more complex.

  • For issues specifically related to your Pinterest ad account or archiving unused tags, you must contact Pinterest Support directly, as these settings are managed on their platform.
  • If you suspect a bug within the Pinterest for WooCommerce plugin itself, detailing your findings from the conflict test can help the plugin's developers investigate.

Remember, diagnosing these issues requires patience and systematic testing. Starting with the Pinterest Tag Helper and a basic conflict test is almost always the fastest path to a resolution.

Related Support Threads Support