Documentation menu

WooCommerce Integration

The PostBeagle for WooCommerce plugin connects your WooCommerce store to PostBeagle so that customers are captured, tagged, and synced automatically — without ever disrupting checkout. Customer data syncs after the order completes, so the plugin has zero impact on checkout performance.

Requirements

  • WordPress 5.8 or higher
  • WooCommerce 5.0 or higher
  • PHP 7.4 or higher
  • A PostBeagle account with API access (see Authentication)

Installation

  1. Upload the plugin to /wp-content/plugins/postbeagle-woocommerce/ (or install the ZIP from the Plugins screen).
  2. Activate PostBeagle for WooCommerce through the Plugins menu.
  3. Go to WooCommerce → PostBeagle Settings.
  4. Enter your PostBeagle API credentials.
  5. Select the target email list new contacts should be added to.
  6. (Optional) Customize the opt-in checkbox text.
  7. (Optional) Configure field mappings.

Features

Checkout opt-in capture

  • Adds an opt-in checkbox to the WooCommerce checkout with customizable text.
  • Opted-in customers are synced to your selected PostBeagle list.
  • Customers are tagged first-time vs. repeat automatically at checkout.
  • Respects double opt-in when it is enabled on your PostBeagle account.
  • If an API call fails, checkout still completes normally and the failure is logged to the WordPress debug log for review.

Order & customer data sync

WooCommerce order data is mapped to PostBeagle custom fields, including:

  • Products, categories, and SKUs purchased
  • Order value
  • Customer lifetime value and order count

You can map additional WooCommerce order fields to PostBeagle custom fields from the field mapping interface.

One-time bulk import

Import your existing WooCommerce customers into PostBeagle in a single batched pass, carrying over lifetime value so historical customers land with the same custom fields as new ones.

WooCommerce automations

Each store event can apply tags and trigger a PostBeagle automation:

TriggerFires when
WelcomeA customer first opts in
First purchaseA customer places their first order
Repeat purchaseA returning customer places an order
Product purchasedA specific product is bought
Abandoned cartA cart is left without checkout
Win-backA lapsed customer is re-targeted

Email capture anywhere

Capture signups outside of checkout with:

  • The [postbeagle_signup] shortcode
  • A Gutenberg block
  • An Elementor widget

Form integrations

The plugin can add a contact, apply tags, and trigger an automation from submissions to:

  • Contact Form 7
  • WPForms
  • Fluent Forms
  • Gravity Forms

Security

  • API keys are stored securely and never exposed to the storefront.
  • The plugin never blocks or delays the checkout process.
  • See the plugin's SECURITY.md for the full security model.

Troubleshooting

  • Customers aren't syncing — confirm the API key is valid and a target list is selected under WooCommerce → PostBeagle Settings, then check the WordPress debug log for logged failures.
  • Custom fields are empty — verify the field mappings; lifetime value and order count require the order to be completed before the sync runs.
  • Double opt-in not firing — double opt-in is controlled by your PostBeagle account settings, not the plugin.