Skip to content
Webilia Docs

How to Sell Monthly and Yearly Auto-Renewing Listing Packages in Listdom

If you want to sell listing packages that renew automatically every month or every year, there are two payment paths in Listdom:

  • WooCommerce Subscriptions
  • Listdom payment engine

The Listdom package controls listing access and submission rules. The payment engine controls checkout, billing cycle, and recurring payment flow. Membership

When to use this

Section titled “When to use this”

Use this guide when you want to:

  • sell a monthly listing package
  • sell a yearly listing package
  • charge users automatically on a recurring cycle
  • keep customer access active while subscription is active
  • choose between WooCommerce Subscriptions and the Listdom payment engine
  • set up recurring directory monetization in Listdom

Before you start

Section titled “Before you start”

Before building monthly or yearly recurring packages, make sure:

  • Listdom is installed and active
  • the Listdom Membership addon is installed and active Membership
  • checkout is working correctly
  • you have decided which payment engine you want to use

You will mainly work in:

  • WP Admin → Listdom → Memberships → Packages
  • WP Admin → Listdom → Memberships
  • WP Admin → Payments (if using Listdom payment engine)
  • WP Admin → Products (if using WooCommerce)
  • Front end → My Account → Subscriptions (if using WooCommerce Subscriptions)

Choose the payment engine first

Section titled “Choose the payment engine first”

Before creating packages, decide your payment path.

Option 1: WooCommerce Subscriptions

Section titled “Option 1: WooCommerce Subscriptions”

Use this option when:

  • you already use WooCommerce on the site
  • you want recurring billing via WooCommerce Subscriptions
  • you want customers to manage subscriptions in WooCommerce My Account

Option 2: Listdom payment engine

Section titled “Option 2: Listdom payment engine”

Use this option when:

  • you do not want to depend on WooCommerce for package billing
  • you want to use Listdom payment plans and recurring payments
  • you want package purchases and renewals handled in Listdom flow

How setup works

Section titled “How setup works”

A recurring package has two connected parts.

Listdom package controls

Section titled “Listdom package controls”
  • listing limit
  • membership duration field
  • available categories
  • auto confirm
  • gallery, description, tags, and submission restrictions
  • membership-based listing access

Payment engine controls

Section titled “Payment engine controls”
  • checkout
  • recurring billing cycle
  • recurring payment status
  • renewal and cancellation lifecycle

For a reliable recurring package, keep these two parts aligned.

Option A: WooCommerce Subscriptions setup

Section titled “Option A: WooCommerce Subscriptions setup”

Step 1: Create subscription product

Section titled “Step 1: Create subscription product”

Go to WP Admin → Products → Add New.

  1. Enter product title.
  2. In Product data, choose Simple subscription.
  3. Set recurring subscription price.
  4. Set payment schedule.
  5. Review Stop renewing after.
  6. Publish product.

Important WooCommerce options

Section titled “Important WooCommerce options”
  • Subscription price: recurring amount charged per renewal.
  • Payment schedule: controls charge interval (monthly/yearly).
  • Stop renewing after: decide whether subscription renews until canceled or ends after fixed billing periods.

For normal auto-renewing packages, keep renewals running until canceled.

Step 2: Create Listdom package

Section titled “Step 2: Create Listdom package”

Go to WP Admin → Listdom → Memberships → Packages.

  1. Click Add New Package.
  2. Enter package title.
  3. Go to Package Settings.

Step 3: Connect package to subscription product

Section titled “Step 3: Connect package to subscription product”

Inside Package Settings:

  1. Find payment plan/product field.
  2. Search for WooCommerce subscription product.
  3. Select it.
  4. Save package.

If you need detailed connection troubleshooting, follow How to Connect a Listdom Package to a WooCommerce Product.

Step 4: Match monthly or yearly values

Section titled “Step 4: Match monthly or yearly values”

For monthly package:

  • Payment schedule = every 1 month
  • Membership Duration = 30

For yearly package:

  • Payment schedule = every 1 year
  • Membership Duration = 365

End-user experience with WooCommerce Subscriptions

Section titled “End-user experience with WooCommerce Subscriptions”

Monthly package:

  • user sees monthly subscription at checkout
  • user is billed every month
  • access continues while subscription remains active

Yearly package:

  • user sees yearly subscription at checkout
  • user is billed every year
  • access continues while subscription remains active

Customers usually manage subscriptions in My Account → Subscriptions.

Option B: Listdom payment engine setup

Section titled “Option B: Listdom payment engine setup”

Step 1: Open Payments area

Section titled “Step 1: Open Payments area”

Go to WP Admin → Payments.

Step 2: Create payment plan

Section titled “Step 2: Create payment plan”

Create payment plan for the membership package.

For recurring billing, create a recurring tier Pro:

  • duration is required
  • duration defines billing interval in days

Examples:

  • monthly recurring tier = 30
  • yearly recurring tier = 365

Step 3: Configure payment settings

Section titled “Step 3: Configure payment settings”

In Payments settings, configure:

  • gateways
  • checkout pages
  • appreciation/success messaging
  • invoicing settings (if needed)

Make sure payment engine is fully configured before testing.

Step 4: Create Listdom package

Section titled “Step 4: Create Listdom package”

Go to WP Admin → Listdom → Memberships → Packages.

  1. Click Add New Package.
  2. Enter package title.
  3. Go to Package Settings.

Step 5: Connect package to Listdom plan

Section titled “Step 5: Connect package to Listdom plan”

Inside Package Settings:

  1. Find payment plan/product field.
  2. Search for Listdom payment plan.
  3. Select it.
  4. Save package.

Step 6: Match package to recurring tier

Section titled “Step 6: Match package to recurring tier”

For clean setup:

  • monthly recurring plan = Membership Duration 30
  • yearly recurring plan = Membership Duration 365

This keeps package wording and access period aligned with recurring billing interval.

End-user experience with Listdom payment engine

Section titled “End-user experience with Listdom payment engine”

Monthly package:

  • user sees monthly recurring plan at checkout
  • user is billed based on recurring tier interval
  • access continues while recurring payment remains active

Yearly package:

  • user sees yearly recurring plan at checkout
  • user is billed based on yearly recurring tier interval
  • access continues while recurring payment remains active

Customers/admins review recurring payments within Listdom payment flow (not WooCommerce My Account).

Step 7: Review key package options

Section titled “Step 7: Review key package options”

Inside Package Settings, review:

  • Listing Limit
  • Membership Duration (monthly 30, yearly 365)
  • One Time Purchase (normally off for recurring packages)
  • Listing Auto Confirm
  • Listing Auto Label
  • Available Categories
  • Maximum Gallery Images
  • Maximum Description Length
  • Maximum Number of Tags
  • Maximum Visits (if supported in your setup)

Step 8: Save package and test Purchase URL

Section titled “Step 8: Save package and test Purchase URL”

After saving:

  1. Confirm correct product/payment plan is selected.
  2. Copy Purchase URL for pricing table or button use.
  3. Test URL in browser.

Purchase URL adds package to cart and sends user to checkout.

What happens after checkout

Section titled “What happens after checkout”

After successful checkout:

  1. recurring payment/subscription is created in selected engine
  2. related membership is created or updated in Listdom
  3. user can submit listings according to package rules
  4. future renewal status follows selected engine lifecycle

Best practice for monthly and yearly packages

Section titled “Best practice for monthly and yearly packages”

For the cleanest setup:

  • monthly billing with 30-day package duration
  • yearly billing with 365-day package duration
  • keep package wording, billing schedule, and access expectations aligned

Notes and limitations

Section titled “Notes and limitations”
  • Monthly/yearly recurring packages can be sold with WooCommerce Subscriptions or Listdom payment engine.
  • Selected payment engine controls billing and renewal lifecycle.
  • Listdom controls package rules and listing access.
  • Billing schedule and package wording mismatches can cause confusion.
  • WooCommerce cancellation flow and Listdom recurring-payment flow are different operational paths.

Troubleshooting

Section titled “Troubleshooting”

Recurring package looks one-time at checkout

Section titled “Recurring package looks one-time at checkout”

Check:

  • for WooCommerce: product type is Simple subscription
  • for Listdom engine: selected payment plan includes recurring tier
  • package is connected to correct product/payment plan

Package renews but membership behavior looks wrong

Section titled “Package renews but membership behavior looks wrong”

Check:

  • recurring payment/subscription status in selected engine
  • membership record in WP Admin → Listdom → Memberships
  • package duration matches intended monthly/yearly model

Package cannot be purchased

Section titled “Package cannot be purchased”

Check:

  • package is connected to valid product/payment plan
  • selected payment engine is configured correctly
  • Purchase URL works correctly

FAQ

Section titled “FAQ”

Should I use WooCommerce Subscriptions or the Listdom payment engine for monthly and yearly packages?

Either works. WooCommerce Subscriptions is usually best when your site already depends on WooCommerce. Listdom payment engine is usually best when you want recurring package billing inside Listdom.

What is the safest setup for a monthly recurring package?

Use a monthly recurring product/plan and match it with a 30-day package duration.

What is the safest setup for a yearly recurring package?

Use a yearly recurring product/plan and match it with a 365-day package duration.

Section titled “Related Articles”
Listdom Payments Documentation