How WooCommerce Subscriptions Works with Listdom Memberships
本頁內容尚未翻譯。
If you sell listing packages with recurring billing, Listdom can connect those packages to WooCommerce subscription products and turn them into memberships for your users. This setup lets you sell monthly or yearly listing access while WooCommerce handles recurring payments and subscription lifecycle events.
When to use this
Section titled “When to use this”Use this guide when you want to:
- sell recurring listing packages
- connect a Listdom package to a WooCommerce subscription product
- let WooCommerce handle renewals while Listdom manages listing access
- understand what happens when a subscription becomes active, on-hold, canceled, or expired
Before you start
Section titled “Before you start”Before setting this up, make sure:
- Listdom is installed and active
- the Listdom Membership add-on Membership is installed and active
- WooCommerce is installed and active
- WooCommerce Subscriptions is installed and active
- you already have at least one WooCommerce subscription product ready
You will mainly work in these menu areas:
- WP Admin → Listdom → Memberships → Packages
- WP Admin → Products
- WP Admin → Listdom → Memberships
How the integration works
Section titled “How the integration works”Listdom and WooCommerce have different roles in this setup.
WooCommerce handles
Section titled “WooCommerce handles”- checkout
- recurring billing
- subscription payment status
- customer subscription lifecycle
Listdom handles
Section titled “Listdom handles”- package rules
- membership creation
- membership status
- listing submission access
- listing limits and package restrictions
When the connected WooCommerce product is a subscription product, Listdom updates memberships from subscription lifecycle events (for example, active, on-hold, canceled, expired) instead of relying only on the standard one-time WooCommerce order completion flow.
Step 1: Create the WooCommerce subscription product
Section titled “Step 1: Create the WooCommerce subscription product”Go to WP Admin → Products → Add New.
- Enter the product name.
- In Product data, select a WooCommerce subscription product type (for example, Simple subscription).
- Set billing terms (price, billing interval, and any optional trial/sign-up settings as needed).
- Publish the product.
This product is the payment plan that your Listdom package will use.
Step 2: Create a Listdom package
Section titled “Step 2: Create a Listdom package”Go to WP Admin → Listdom → Memberships → Packages.
- Click Add New Package.
- Enter the package title.
- Open the Package Settings box.
This is where you define the membership rules for the package.
Step 3: Connect the package to the WooCommerce subscription product
Section titled “Step 3: Connect the package to the WooCommerce subscription product”Inside Package Settings, select the WooCommerce product for the package. If you need detailed field-by-field instructions, see How to Connect a Listdom Package to a WooCommerce Product.
Important points:
- the package must be connected to a payment plan or WooCommerce product
- if no product is connected, the package cannot be purchased correctly
- you can also connect a free WooCommerce product or payment plan if needed
If this connection is missing, the package cannot complete the normal purchase flow.
Step 4: Configure key package options
Section titled “Step 4: Configure key package options”Inside Package Settings, review these options carefully:
- Listing Limit: leave blank for unlimited submissions, or set a numeric cap
- Membership Duration: enter days, or leave blank for no expiration
- One Time Purchase: limit package purchase to once per user when needed
- Listing Auto Confirm: auto-publish listings submitted through this package
- Listing Auto Featured: mark listings as featured automatically (if available in your setup)
- Available Categories: restrict package use to selected categories
- Maximum Gallery Images: limit gallery images per listing
- Maximum Description Length: limit listing description size
- Maximum Number of Tags / items: cap supported listing fields based on your configuration
- Maximum Visits: apply visit/visibility-related limits if configured
Step 5: Save the package
Section titled “Step 5: Save the package”After configuring the package:
- Publish or update the package.
- Make sure the WooCommerce product is still assigned.
- Copy or use the Purchase URL for pricing tables or CTA buttons.
The Purchase URL can add the package to the cart and send the user to checkout.
Step 6: User purchase flow
Section titled “Step 6: User purchase flow”When a user buys the package through WooCommerce:
- the WooCommerce subscription product is added to cart
- checkout is completed in WooCommerce
- the subscription lifecycle starts in WooCommerce Subscriptions
- Listdom creates or updates the membership based on subscription status
What happens after checkout
Section titled “What happens after checkout”After successful checkout, the package can lead to a membership for the user.
Depending on your membership settings, you may also use:
- Auto Order Complete
- Redirect to Add Listing Form
These options help streamline post-checkout dashboard flow. See Membership add-on documentation for where these options are configured.
Renewal behavior
Section titled “Renewal behavior”When a WooCommerce subscription renews successfully:
- the WooCommerce subscription stays active
- the related Listdom membership is renewed
- membership expiry is extended based on the next billing cycle
WooCommerce controls billing schedule; Listdom controls listing access tied to the package.
Status sync behavior
Section titled “Status sync behavior”WooCommerce subscription status changes are reflected in the related Listdom membership.
- Active: membership becomes active or renews
- On hold: membership is placed on hold
- Canceled: membership is canceled
- Expired: membership expires
Where to check memberships after purchase
Section titled “Where to check memberships after purchase”Go to WP Admin → Listdom → Memberships.
There you can review:
- member
- package
- membership start time
- expiry time
- status
- usage
- related listings
- related payment order or WooCommerce order
Front-end membership selection flow
Section titled “Front-end membership selection flow”If a user tries to submit a listing without a valid membership, Listdom can show a membership selection screen with:
- current memberships
- available packages
- checkout/purchase actions
- membership change flow
This helps users pick a valid package before adding listings.
Notes and limitations
Section titled “Notes and limitations”- WooCommerce Subscriptions handles recurring billing, not Listdom.
- Listdom handles membership access and listing restrictions.
- A package must be connected to a WooCommerce product or payment plan.
- Subscription products follow subscription lifecycle events, not only one-time order behavior.
- Final dashboard behavior can depend on checkout and redirect settings.
Troubleshooting
Section titled “Troubleshooting”The package cannot be purchased
Section titled “The package cannot be purchased”Check these items:
- make sure the package is connected to a WooCommerce product
- make sure the product is published
- make sure the user is logged in if your purchase flow requires login
- review WooCommerce settings at WP Admin → WooCommerce → Settings → Products and checkout access settings
The membership was not created after checkout
Section titled “The membership was not created after checkout”Check these items:
- make sure the product is a valid WooCommerce subscription product
- make sure the package is connected to that product
- make sure checkout completed successfully
- check WP Admin → Listdom → Memberships
The membership did not renew
Section titled “The membership did not renew”Check these items:
- make sure subscription renewal payment succeeded
- make sure the WooCommerce subscription is still active
- check related membership status and expiry time
The membership was canceled unexpectedly
Section titled “The membership was canceled unexpectedly”Check these items:
- review WooCommerce subscription status
- check whether it was canceled, expired, or set to on-hold
- review related WooCommerce orders and membership records
Does WooCommerce Subscriptions extend the Listdom membership automatically?
Yes. When the connected WooCommerce subscription renews successfully, the related Listdom membership renews as well.
Who controls recurring payments in this setup?
WooCommerce Subscriptions controls the recurring payment schedule and billing lifecycle.
Who controls listing access and package limits?
Listdom controls membership rules, listing limits, and package restrictions.