How Listdom Membership Duration Works with WooCommerce Subscriptions
本頁內容尚未翻譯。
When you use WooCommerce Subscriptions with Listdom Memberships, there are two different time systems involved:
- the Membership Duration field in the Listdom package
- the subscription billing schedule and subscription end date in WooCommerce Subscriptions
These settings are related, but they do not always control the same thing. In a WooCommerce Subscriptions setup, the subscription lifecycle can override expected access behavior if you only look at the package duration field by itself.
When to use this
Section titled “When to use this”Use this guide when you want to:
- understand what Membership Duration does in a Listdom package
- connect a package to a monthly or yearly WooCommerce subscription product
- avoid wrong assumptions about expiry and renewal
- understand when WooCommerce subscription status has priority over the package duration field
Before you start
Section titled “Before you start”Before configuring duration settings, 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 a WooCommerce subscription product ready
You will mainly work in these menu areas:
- WP Admin → Listdom → Memberships → Packages
- WP Admin → Products
- WP Admin → Listdom → Memberships
The difference between the two duration settings
Section titled “The difference between the two duration settings”Membership Duration in Listdom
Section titled “Membership Duration in Listdom”The Membership Duration field is inside Listdom package settings.
Go to WP Admin → Listdom → Memberships → Packages → Edit Package → Package Settings.
This field is used by Listdom when it calculates package-based access duration.
In general:
- enter a number to define package duration in days
- leave it blank if you do not want to store a fixed day value in that field
Subscription timing in WooCommerce Subscriptions
Section titled “Subscription timing in WooCommerce Subscriptions”The WooCommerce subscription product controls payment lifecycle.
Go to WP Admin → Products → Edit Product.
In the subscription product, WooCommerce controls:
- recurring price
- billing interval
- billing period (such as month or year)
- whether the subscription renews until canceled
- whether the subscription ends after a fixed subscription length
The key practical rule
Section titled “The key practical rule”When you use a package with a WooCommerce subscription product, do not assume that the package duration field alone determines final membership expiry. This guide works best alongside How WooCommerce Subscriptions Works with Listdom Memberships and How to Connect a Listdom Package to a WooCommerce Product.
In this integration, WooCommerce subscription events can update the related membership in Listdom. For practical setup, the safest approach is:
- treat Membership Duration as the package-side duration field
- treat WooCommerce subscription product settings as the billing and subscription lifecycle controller
- keep both settings aligned unless you have a specific reason not to
What usually works best
Section titled “What usually works best”Monthly package
Section titled “Monthly package”Use this setup if you charge every month.
In WooCommerce
Section titled “In WooCommerce”Go to WP Admin → Products → Edit Product and set:
- product type to a subscription product
- billing interval to every 1 month
- subscription price to the monthly amount
- subscription length according to your business model
In Listdom
Section titled “In Listdom”Go to WP Admin → Listdom → Memberships → Packages → Edit Package → Package Settings and set:
- Membership Duration to
30
Yearly package
Section titled “Yearly package”Use this setup if you charge every year.
In WooCommerce
Section titled “In WooCommerce”Go to WP Admin → Products → Edit Product and set:
- product type to a subscription product
- billing interval to every 1 year
- subscription price to the yearly amount
- subscription length according to your business model
In Listdom
Section titled “In Listdom”Go to WP Admin → Listdom → Memberships → Packages → Edit Package → Package Settings and set:
- Membership Duration to
365
What happens if Membership Duration is blank
Section titled “What happens if Membership Duration is blank”If you leave Membership Duration blank, do not assume that this always means a simple recurring package with unlimited access.
A blank package duration only means the package itself does not store a fixed day value in that field.
What the end user will face
Section titled “What the end user will face”From the customer’s point of view, behavior is primarily driven by the WooCommerce subscription they bought:
- checkout and billing schedule come from WooCommerce subscription product settings
- renewal behavior depends on the subscription staying active
- cancellation and expiry behavior depend on subscription lifecycle
In practical terms:
- if the subscription renews until canceled, access usually continues while subscription stays active
- if the subscription has a fixed end date, access usually ends in line with that lifecycle
What this means for the site owner
Section titled “What this means for the site owner”For site owners, a blank duration can make package behavior harder to interpret because:
- package settings no longer show a simple day-based access rule
- final timing depends more on WooCommerce subscription lifecycle
- support and backend reviews can become less predictable
Best practice for blank duration
Section titled “Best practice for blank duration”Leave Membership Duration blank only when you intentionally want that behavior and understand the connected WooCommerce subscription setup.
For most recurring packages, fixed matching values are easier to manage:
- monthly product with
30 - yearly product with
365
Step-by-step setup
Section titled “Step-by-step setup”Step 1: Open the WooCommerce subscription product
Section titled “Step 1: Open the WooCommerce subscription product”Go to WP Admin → Products.
- Open the subscription product you want to use.
- Review recurring price.
- Review billing period and billing interval.
- Review whether the subscription continues until canceled or ends after fixed length.
Step 2: Open the Listdom package
Section titled “Step 2: Open the Listdom package”Go to WP Admin → Listdom → Memberships → Packages.
- Open the package you want to connect.
- Go to Package Settings.
- Confirm the correct WooCommerce product is selected.
Step 3: Set Membership Duration
Section titled “Step 3: Set Membership Duration”Inside Package Settings:
- Find Membership Duration.
- Enter the number of days that matches the package access period you sell.
- Leave it blank only if you intentionally want no fixed day value.
For most setups:
- monthly package =
30 - yearly package =
365
Step 4: Review other package options
Section titled “Step 4: Review other package options”Also review:
- Listing Limit
- One Time Purchase
- Listing Auto Confirm
- Available Categories
- Maximum Gallery Images
- Maximum Description Length
- Maximum Number of Tags
- Maximum Visits (if supported in your setup)
These settings affect membership access rules, not WooCommerce billing cycle.
Step 5: Save and test
Section titled “Step 5: Save and test”After saving:
- Purchase the package with the connected subscription product.
- Go to WP Admin → Listdom → Memberships.
- Review created membership.
- Check status and expiry details.
- Compare with related WooCommerce subscription.
How renewal works in practice
Section titled “How renewal works in practice”When the WooCommerce subscription renews successfully:
- subscription stays active in WooCommerce
- related membership is renewed or updated in Listdom
- membership timing follows subscription lifecycle rather than package field alone
This is why matching package duration to billing cycle is usually safest.
When mismatches can cause confusion
Section titled “When mismatches can cause confusion”A mismatch happens when package duration and WooCommerce subscription plan imply different access expectations.
Example mismatch 1
Section titled “Example mismatch 1”- WooCommerce product bills monthly
- package duration is set for a yearly period
What users experience:
- checkout still shows monthly recurring payment
- customer is still billed monthly
- access can remain active while subscription remains active
The mismatch mainly creates backend/config confusion rather than changing billing frequency.
Example mismatch 2
Section titled “Example mismatch 2”- WooCommerce product bills yearly
- package duration is set for a monthly period
What users experience:
- checkout still shows yearly recurring payment
- customer still pays yearly
- access can continue while subscription remains active
Again, mismatch mainly creates setup and support confusion.
Notes and limitations
Section titled “Notes and limitations”- Membership Duration is a package field in Listdom.
- WooCommerce Subscriptions controls billing lifecycle.
- Final membership timing in this integration should not be inferred from package field alone.
- Leaving Membership Duration blank is not the recommended default for recurring packages unless intentional.
- Safest default is to align package duration with subscription cycle.
Troubleshooting
Section titled “Troubleshooting”My monthly plan is not behaving as expected
Section titled “My monthly plan is not behaving as expected”Check:
- WooCommerce product bills every 1 month
- Membership Duration is
30if that is your intended model - created membership in WP Admin → Listdom → Memberships
- related WooCommerce subscription details
My yearly plan is not behaving as expected
Section titled “My yearly plan is not behaving as expected”Check:
- WooCommerce product bills every 1 year
- Membership Duration is
365if that is your intended model - membership status and expiry after checkout and renewal
I left Membership Duration blank and result is confusing
Section titled “I left Membership Duration blank and result is confusing”Check:
- whether subscription has a fixed end date or renews until canceled
- related membership record in WP Admin → Listdom → Memberships
- full flow with a new subscription test
I changed WooCommerce product, but membership timing still looks wrong
Section titled “I changed WooCommerce product, but membership timing still looks wrong”Check:
- correct WooCommerce product is connected to package
- package still has intended Membership Duration value
- test with a new purchase after saving changes
Does Membership Duration control the WooCommerce billing cycle?
No. WooCommerce Subscriptions controls billing. Membership Duration is package-side in Listdom.
Should I match Membership Duration to the WooCommerce billing period?
Yes. In most cases, that is the safest and clearest setup.
What happens if I leave Membership Duration blank?
The package stores no fixed day value in that field, so check final behavior against subscription lifecycle and the real membership record.