Listing Packages

​

What Are Listing Packages?

A listing package is a WooCommerce product that becomes a plan. The plan decides how many listings someone can publish, how long those listings stay live, and which extras they include. Think of it this way:

• A listing is one entry on your site (one restaurant, one event, or one job).
• A listing package is the plan attached to that entry.
• A user package is the copy of that plan stored on the customer’s account after checkout. MyListing uses the user package to count listings and apply the plan’s rules. Paid listings use WooCommerce for checkout, orders, and (when you sell subscriptions) recurring billing. You still build the listing itself in MyListing.

​

The Three Package Types

Listing Package and Listing Subscription products are the plans in the Choose a package step. Promotion Package products never appear there. They are a separate purchase that raises a published listing in search for a set number of days.

​

Where Do You Manage Listing Packages?

Setup spans four places.

​

Turn Paid Listings On

Go to WP Admin > Listings > Settings. Enable Paid Listings connects WooCommerce listing products to the Add Listing feature. This option is on by default. When it is on, an account is always required to submit paid listings. On the same screen, review: Allow switching listing packages; there are three choices:

• Users can switch without admin approval
• Users can switch, but a new listing with a new plan requires admin approval. The original listing is unpublished while you review it.
• Users cannot switch listing plans

​

Create the Products

Go to WP Admin > Products > Add New. Set the Product data to Listing Package, Listing Subscription, or Promotion Package. Listing Subscription is available only when WooCommerce Subscriptions is active. These product types are virtual, so checkout does not ask for a shipping address. Listing Package and Listing Subscription products are sold one at a time.

​

Choose Which Plans a Listing Type Can Use

Go to WP Admin > Listing Types, edit a type, and open General > Packages.

​

Review What Each Customer Owns

​

Listing Package Settings

Edit a Listing Package product. The package panel includes: The product name is the plan name on the pricing card. The product short description sits under the price. A price of 0 skips checkout, so a free plan can publish without payment. That skip does not run when the Disable repeat purchase? option is checked. is checked. In that case the customer still goes through checkout, and after they have bought it, the card says, “This item can only be purchased once.”

​

Listing Subscriptions

A Listing Subscription uses the same package settings as a listing package, plus WooCommerce subscription billing (price, billing period, trial, and sign-up fee). For a directory you plan to run long-term, subscription plans are the stronger default. Owners can move between plans, and listings can stay online for as long as the subscription is paid. A one-time Listing Package has to be renewed by hand when it expires.

​

Subscription Type

Subscription Type controls what renews. Choose it before you publish the product.

​

Upgrades and Downgrades

Owners can move between Listing Subscription products when WooCommerce allows subscription switching. Go to WP Admin > WooCommerce > Settings > Subscriptions. Enable switching Between Grouped Subscriptions when your plans live in a grouped product. That is the usual setup for monthly and annual tiers, or for Basic, Featured, and Premium as a set. When switching is allowed, a published listing shows Upgrade on My Listings. The action title reads Upgrade or Downgrade. The customer completes the switch in WooCommerce. MyListing then applies the new plan. If switching is off, owners use Switch Plan instead, which sends them back through package selection for that listing.

​

Promotion Packages

A promotion is a timed boost you sell after a listing is published. It does not replace the listing plan. Create a product and set Product data to Promotion Package.

​

Assign Plans to a Listing Type

Paid listings can be on for the whole site and off for one listing type. Go to WP Admin > Listing Types, edit the type, and open General > Packages.

​

What Listing Owners See

​

The Choose a Package Step

Owners see Choose a package when Enable Paid Listings is on, Enable paid listing packages is on for that type, and the URL has not already skipped the step. Each card shows the plan name, price, short description, and feature list. The Add Listing widget controls the row: Show 3 packages per row or Show 4 packages per row. A pricing page can send people in with a plan already chosen. Add the MyListing > Package Selection widget in Elementor. For each item, set Choose package, optional Featured?, and where the button should go (Submit to Page or Submit to URL). Those buttons open Add Listing with that product selected. A front-facing pricing page is worth building. It is where people compare limits and features before they start the form.

​

My Listings Actions

On My Account > My Listings, owners may see: Promote lists promotion products they can buy and Owned packages they have not used yet. If none exist, the dialog reads: There aren’t any promotion packages available at the moment.

​

Promotions in My Account

My Account > Promotions lists active boosts, the order, and the expiry line Expires in:. Owners can Cancel Package. Example URL: https://yoursite.com/my-account/promotions If the account has no promotions, the page reads: You don’t have any promoted listings yet.

​

Different Fields for Different Plans

A cheaper plan can collect fewer details than a premium plan. Edit the listing type, open Fields, and expand a field (Title is excluded). Turn on Enable package visibility. The rule reads Show this field if, then Listing Package, is equal to, and the plan (or No Package). The same Enable package visibility control exists on the Raw and Google Ad content blocks: Show this block if. On Single Page > Similar Listings, Enable package visibility? limits that section to plans whose WooCommerce product IDs you list under Display Similar Listings for Package IDs. Listings with no package are included when you add no-package.

​

How a Purchase Becomes a User Package

1. The owner picks a plan, fills in the listing, and previews it.
2. A paid plan goes to WooCommerce checkout. A free Listing Package with a price of 0 can skip checkout.
3. When the order is paid, MyListing creates a user package and assigns it to the listing.
4. The listing is published or left pending, based on Require admin approval of all new listing submissions.

If Listing limit is greater than 1, the owner can use that same package again until the count reaches the limit. On the package step, the user selects Use Available Package. Go to WP Admin > Users > Paid Listing Packages to view these records. Open one to edit Package Details and Payment Details. The screen notes: Editing these values won’t affect existing listings, only new listings added with this package. Statuses: To give someone a plan without sending them through the public form, create a completed order for that customer that contains the product, then confirm the user package under Users > Paid Listing Packages. On the listing, click Switch Package, choose Select Package, and click Apply. For a Listing Subscription, also create an active subscription tied to that order before you add the user package. Set Subscription Status to Active, set the parent order, and add the same subscription product.

​

Claims and Packages

Claims are a separate flow from Add Listing. Someone takes over a listing that already exists.

• Use for Claim? puts the product on the claim package step.
• Don’t use for add listing? keeps that product off the public Add Listing form.
• Is claimable? lets listings created with the plan still be claimed later. Listings that have no package assigned can be claimed when claims are enabled. Assigning a paid package, with Is claimable? on, lets you hand a stronger plan to a listing you added yourself and still let the real owner claim it. Enable claims under WP Admin > Listings > Settings > Claim Listings, and point Claim Listing Page at a page that contains [claim_listing].

​

How the Pieces Fit Together

A practical example for a local business directory:

1. Listings > Settings: Enable Paid Listings on, accounts required, approval on, Listing Duration 30.
2. Products: a free Listing Package (price 0, limit 1, Disable repeat purchase? on) and a monthly Listing Subscription (limit 1, Feature Listings? on, Mark as verified? on, Subscription Type linked to posted listings).
3. WooCommerce > Settings > Subscriptions: switching enabled Between Grouped Subscriptions, with the paid tiers in one grouped product.
4. Listing Types > Business > General > Packages: both plans added. The subscription card has Featured? on, and its Description lists one perk per line.
5. Fields: logo, gallery, and website use Enable package visibility so they show only for the subscription.
6. Products: a Promotion Package, 14 days, priority 2.
7. Owner path: pick Business, choose the subscription, submit details, pay, wait for approval. Later they click Promote on My Listings for a two-week boost.

​

Common Package Setups

There is no single required setup. One-time packages are enough for a small site. Subscriptions are the better fit when you want renewals and self-serve upgrades.

​

Helpful Tips

• Turn packages on per listing type. Site-wide Enable Paid Listings is not enough. Each type needs Enable paid listing packages, plus the products you want on that type.
• Set Subscription Type on purpose. The two options renew different things: the live listing or the number of listings the customer can post.
• Keep Featured and Promoted separate in your pricing copy. Feature Listings? lasts as long as the plan applies. A Promotion Package lasts for the number of days on the product.
• Highlight the card you want people to choose. Featured? on the listing type package is the pricing-card badge. It does not change search ranking.
• Write features as separate lines. On the listing type package, each line in Description becomes a bullet. Leave it blank to fall back to the product description.
• Cap the free plan. Set Listing limit to 1 and turn on Disable repeat purchase? so the free product cannot be bought again.
• Hide claim plans from Add Listing. Don’t use for add listing? keeps claim products off the public package step.
• Test with a second user. Buy a plan, submit a listing, and confirm the row under Users > Paid Listing Packages. Then use Use Available Package for a second listing if the limit allows it.

​

Quick Reference

​

Where to Go Next

• Add Listing Flow: the Choose a package step, pricing-page links, and what happens after checkout.
• WooCommerce: store settings, payments, and how listing products fit the shop.
• Listing Priority: Featured plans, promotion priority numbers, and Explore sorting.
• Listing Types: fields, single-page blocks, and the Packages tab.
• Listing Packages: MyListing Pro purchase limits, plan priority, pinned plans, and featured badges.
• Pricing Table Switcher: monthly and annual prices on the same pricing tables.
• MyListing Club mega guide: Listing Packages, Paid Listing Packages, and subscription switching in a full site build.

​

Common Questions

• Do I need WooCommerce? Yes, if any listing type sells a plan or a promotion. Leave Enable paid listing packages off on every type when the directory is free.
• Why is there no package step? Enable Paid Listings is off under Listings > Settings, or Enable paid listing packages is off for that type under Listing Types > General > Packages.
• Why does my plan not show on Add Listing? The product must be a Listing Package or Listing Subscription, it must be added on that type’s Packages tab, and Don’t use for add listing? must be off. Promotion products never appear on this step.
• What is the difference between a Listing Package and a Listing Subscription? A Listing Package is a one-time purchase. A Listing Subscription bills on a schedule and needs WooCommerce Subscriptions. Use Subscription Type to decide whether each renewal keeps listings online or refills the listing limit.
• What is the difference between Feature Listings? and a Promotion Package? Feature Listings? marks listings from that plan as featured for as long as the plan applies. A Promotion Package is a separate product the owner buys later, for a set number of days, at the priority you set (placeholder 2).
• What is the difference between Featured? and Feature Listings?? Featured? on the listing type highlights the pricing card. Feature Listings? on the product changes the listing’s rank in search.
• Why did a free plan still go to checkout? A price of 0 skips checkout only when Disable repeat purchase? is off. With that box checked, the customer checks out once, then sees This item can only be purchased once.
• Can one plan allow different counts per listing type? Yes. Set Listing limit, then use Add listing limit by listing type. The per-type numbers cannot add up to more than Listing limit.
• Can I show a gallery only on the premium plan? Yes. On that field, enable Enable package visibility and set Show this field if the Listing Package is equal to the premium product.
• How do owners change plans? From My Listings, Switch Plan opens package selection. Upgrade appears on a published subscription listing when WooCommerce subscription switching is enabled. Allow switching listing package can block switching or require your approval.
• Can I assign a plan without the customer checking out? Yes. Create a completed order (and an active subscription, for a Listing Subscription), confirm the user package under Users > Paid Listing Packages, then use Switch Package on the listing.
• What happens when a promotion expires? The listing returns to its previous priority. The package moves to the Expired view under Users > Promotion Packages. Filenam