WooCommerce Subscriptions

The WooCommerce Subscriptions integration enables you to personalise content based on a visitor's subscription status and plan type. This feature allows you to create subscriber-exclusive content, renewal messaging, and tiered experiences based on active subscription products within your WooCommerce Subscriptions setup.

Overview

This integration connects PersonalizeWP directly with WooCommerce Subscriptions data, checking a visitor's current subscription status in real-time. You can show or hide content based on whether visitors have active subscriptions to specific products, creating sophisticated subscriber-only experiences that automatically adapt to subscription changes.

The integration works by querying subscription data stored as custom post types within WooCommerce Subscriptions, ensuring compatibility with all subscription product types including simple subscriptions, variable subscriptions, and subscription variations.

Prerequisites

Before using the WooCommerce Subscriptions integration:

PersonalizeWP Pro must be installed and activated
WooCommerce and WooCommerce Subscriptions must be installed and activated
At least one subscription product must be created in WooCommerce
Your site must have customers with active subscription purchases
Visitors must be logged in for subscription-based personalisation to function

Setting Up WooCommerce Subscriptions Integration

Accessing the Integration

Edit any block in the WordPress Block Editor
Open the PersonalizeWP panel in the sidebar
Locate the Integrations section (appears above the Outcome panel)
WooCommerce Subscriptions will automatically appear in the dropdown if the plugin is active and subscription products exist

[Screenshot: Integrations dropdown with WooCommerce Subscriptions option]

Basic Configuration

Select Integration: Choose "WooCommerce Subscriptions" from the Integrations dropdown
Choose Subscription Products: A multi-select field appears displaying all available subscription products from your WooCommerce store
Select Target Subscriptions: Choose one or more subscription products that should grant access to the content
Set Visibility Action: Use the Show/Hide toggle to determine whether content should be visible or hidden for subscribers to the selected products

[Screenshot: WooCommerce Subscriptions product selection interface]

Advanced Configuration Options

Multiple Subscription Selection: You can select multiple subscription products simultaneously. Visitors who have active subscriptions to any of the selected products will match the criteria. The logic operates as an OR condition - visitors need only one active subscription to the selected products to qualify.

Subscription Status Validation: The integration only recognises active subscriptions. Cancelled, expired, suspended, or pending subscriptions will not grant access to integrated content. This ensures that subscription-based content remains properly protected and only accessible to paying subscribers.

Product Variation Support: For variable subscription products, the integration recognises subscriptions to any variation of the selected product. You don't need to select individual variations - selecting the parent variable product will match all its subscription variations.

Integration Priority: When a WooCommerce Subscriptions integration is active on a block, all other PersonalizeWP targeting options (Rules, Lead Scores, Segments) are automatically disabled to prevent conflicts. The subscription integration takes priority in determining content visibility.

HPOS Compatibility: The integration is fully compatible with WooCommerce's High-Performance Order Storage (HPOS) system, automatically detecting whether your store uses traditional WordPress post tables or the newer HPOS structure.

Troubleshooting

Integration Not Available

If WooCommerce Subscriptions doesn't appear in the Integrations dropdown:

Verify WooCommerce Subscriptions is installed and activated
Ensure at least one subscription product exists in your WooCommerce store
Check that PersonalizeWP Pro license is valid and activated
Refresh the Block Editor page after activating WooCommerce Subscriptions

No Subscription Products Showing

If the subscription products multi-select field is empty:

Navigate to WooCommerce > Products and verify subscription products exist
Check that subscription products are published (not in draft status)
Ensure products are properly configured as subscription products in WooCommerce Subscriptions
Try creating a test subscription product to confirm the integration detects new products

Content Not Displaying for Subscribers

If content isn't showing for users who should have access:

Verify the user is logged into WordPress with the same account used for subscription purchase
Check the user's subscription status in WooCommerce > Subscriptions
Confirm the user's subscription is active (not cancelled, expired, or suspended)
Verify the correct subscription product is selected in the PersonalizeWP integration settings
Test with the "Show" action selected (not "Hide")

Content Showing to Non-Subscribers

If subscription-protected content appears to users without active subscriptions:

Check that the integration is properly configured with specific subscription products selected
Verify the "Show" action is selected (not "Hide")
Ensure no other PersonalizeWP rules are conflicting with the subscription integration
Test with an incognito browser session or logged-out user to confirm protection is working

Subscription Status Changes Not Reflecting

If subscription status changes aren't immediately reflected in personalised content:

Subscription status is checked in real-time on each page load
For recently cancelled or expired subscriptions, changes should be immediate
If using caching plugins, clear cache or configure cache exclusions for personalised content
Ask affected users to log out and log back in to refresh their session

Variable Subscription Issues

When working with variable subscription products:

Selecting the parent variable product automatically includes all variations
You don't need to select individual subscription variations
If targeting specific variations only, this requires custom development beyond the standard integration

Multiple Subscription Logic Issues

When using multiple subscription products in a single integration:

Remember the logic is OR-based: users need only one active subscription to the selected products
If you need AND logic (user must have multiple specific subscriptions), create separate blocks with different integration rules
Test with user accounts that have different combinations of the selected subscriptions

The WooCommerce Subscriptions integration provides a powerful way to create subscriber-exclusive experiences that automatically adapt to subscription status changes, ensuring your personalised content remains properly targeted to active subscribers while encouraging engagement and retention.