Skip to main content
MyListing Pro adds improvements to the Add Listing Flow: Checkout Before Listing, drag-to-reposition cover images, listing counters on type cards, and custom pending-submission messages.
MyListing Pro includes a Listing Type Editor module that greatly enhances the overall experience when building and managing Listing Types.
MyListing Club provides pre-configured Pricing Pages to speed up your build.
This document references reCAPTCHA throughout, but we don’t recommend it. It negatively impacts the user experience, slows down your website, introduces privacy issues, and kills conversions. There are better options.

​
What Is the Add Listing Flow?

The Add Listing flow is the front-end wizard a visitor or logged-in user follows to submit a new listing on your site. Think of it as a guided path:
  • The user lands on your Add Listing page (built with Elementor).
  • They pick a listing type (for example, Restaurant or Event) unless only one type is offered.
  • If paid packages are enabled for that type, they select a package.
  • They fill in listing details (fields you configured for that listing type).
  • They preview the listing and submit it.
  • MyListing processes payment (if required), sets the listing status, and shows a done message.
Every step pulls its fields, packages, and rules from the listing type the user selects. Site-wide settings under Listings > Settings control whether accounts are required, whether admin approval is needed, and how paid packages work. The same form also powers editing an existing listing when the user opens it from My Account > My Listings or a direct edit link.

​
Where You Set Up the Add Listing Flow

Setup spans four areas: the Elementor page, listing types, site-wide settings, and user roles.

​
The Add Listing Page

Create or edit a WordPress page in Elementor, then add the 27 > Add Listing Form widget. This widget drives the entire flow. In the widget settings: Listing type selection step Package selection step If you configure only one listing type in the widget, visitors skip the type-selection cards and go straight to the form. Tell MyListing which page is the Add Listing page: Go to WP Admin > Theme Tools > Theme Options, open the Explore tab, and set Default ‘Add a Listing’ page. Also link the header CTA to this page under Theme Tools > Theme Options > Header > Call to Action Links to Page so the Add Listing button points to the correct URL.

​
Listing Types (Fields and Packages)

Go to WP Admin > Listing Types and edit each type.
  • Fields tab: controls which questions appear on the Add Listing form. Only fields with Show in submit form enabled are shown.
  • General > Packages tab: turn Enable paid listing packages on or off for each listing type and choose which WooCommerce listing plans apply.
Do not use a global listing type on the Add Listing page. Global types are for cross-type search on the Explore page only.

​
Site-Wide Submission Settings

Go to WP Admin > Listings > Settings (General section). These settings apply to every listing type unless noted.

​
Who Can Submit Listings

Go to WP Admin > Theme Tools > User Roles. Each role has a toggle: Allow users with this role to submit new listings through the Add Listing form. Users without this permission cannot start a new submission, even if they can log in.

​
The Steps Users See

The exact steps depend on your configuration. Here is the typical order. 1. Choose a Listing Type Shown when the Add Listing widget lists more than one listing type and the URL does not already include a type. Users see flipping cards with each type’s icon and name. Clicking a card takes you to that type. Example URL after selection: https://yoursite.com/add-listing/?listing_type=restaurant 2. Account (When Required) If the user is not logged in, an Account section appears at the top of the form with Sign in and Register links. When Require an account to submit listings is enabled, the message reads: You must be logged in to post new listings. When Enable Paid Listings is on, an account is always required for paid submissions, even if the general account setting is off. 3. Choose a Package Shown when all of the following are true:
  • Enable Paid Listings is on site-wide
  • Enable paid listing packages is on for the listing type
  • The user has not preselected a package in the URL
The heading reads Choose a Package. Users pick a WooCommerce listing plan or an existing package from their account. 4. Submit Details The main form section is titled Your listing details. Fields come from the Fields tab for the listing type. Form buttons at the bottom: Title is always required. Other required fields depend on your listing type configuration. 5. Preview Users see how the listing will look on the single listing page. Buttons:
  • Submit Listing continues to checkout or final submission.
  • Edit listing returns to the form to make changes.
6. Done A success message appears based on the listing status: Paid submissions may also show a message that the listing will be visible once payment is confirmed. You can send users directly to a specific step using URL parameters on the Add Listing page. Pricing pages often use 27 > Package Selection to link to the Add Listing page with selected_package already set, so users pick a plan on the pricing page and continue straight into submission. Example deep link to start a restaurant listing: https://yoursite.com/add-listing/?listing_type=restaurant Example edit link (from My Listings): https://yoursite.com/add-listing/?listing=565

​
Editing an Existing Listing

Listing owners edit listings through the same Add Listing form on the same page. Common entry points:
  • My Account > My Listings > Edit on a listing
  • Edit listing link on the single listing page (visible to the listing owner)
  • Direct URL with ?listing={id} on the Add Listing page
Whether editing is allowed depends on Listings > Settings: When moderation is required for published edits, the original listing is unpublished while edits await admin approval. Package switching and relisting use separate dashboard actions, not the standard Add Listing form.

​
Site-Wide Settings That Shape the Flow

​
Free vs Paid Submissions

​
Free Listing (No Packages for This Type)

  1. Choose type (if needed)
  2. Submit Details
  3. Preview
  4. Done
If paid listings are disabled for the listing type, the package step is skipped. After preview, MyListing publishes the listing or sets it to pending, depending on your approval setting.
  1. Choose type (if needed)
  2. Choose a Package
  3. Submit Details
  4. Preview
  5. Checkout (WooCommerce) or use an existing package
  6. Done
Users may apply a package they already own from a previous purchase instead of buying again. Free packages can skip checkout when configured in WooCommerce.

​
Add Listing vs Claim Listings

These are separate flows. Claim submissions can also involve package selection, but they start from a listing’s Claim action, not the Add Listing page.

​
How the Pieces Fit Together

Example for a Restaurant directory with paid plans:
  1. Listing type: Restaurant with Location, Category, Cover, and Work Hours fields on the submit form.
  2. Packages: Basic (free) and Featured (paid) are enabled under General > Packages.
  3. Add Listing page: Elementor page with 27 > Add Listing Form listing Restaurant and Event types.
  4. Listings > Settings: Require account on, require approval on.
  5. Theme Options: Default ‘Add a Listing’ page assigned; header CTA links to the same page.
  6. User journey: Pick Restaurant, choose Featured plan, fill in details, preview, pay at checkout, listing goes to pending until you approve it.

​
Common Add Listing Setups

​
Helpful Tips

  • Start with one listing type. Add more types to the widget when you are ready for flipping cards.
  • Match fields to the single page. Fields only collect data. Add matching content blocks on the Single Page tab so the information appears after submission.
  • Test both logged-in and logged-out states. Account requirements and package flows behave differently for guests vs. registered users.
  • Build a pricing page first. Front-facing pricing educates users before they enter the flow. Link plans to the Add Listing page with selected_package.
  • Exclude claim-only packages. On each WooCommerce listing product, hide packages from the Add Listing flow when they are meant for claims only.
  • Link to the page everywhere. Set the default ‘Add a Listing’ page in Theme Options so header buttons and dashboard links point to the correct URL.
  • Use direct links in marketing. Share ?listing_type=your-slug URLs in emails or ads to skip the type-selection step.
  • Regenerate preview cards after design changes. If preview cards look stale after submission, regenerate the cache under Listings > Settings (Preview Cards section).

​
Quick Reference

​
Where to Go Next

  • Listing Types: Fields, packages, and single page layout for each listing type.
  • Elementor: How to build the Add Listing page and configure the 27 > Add Listing Form widget.
  • WooCommerce: Listing packages, products, and checkout for paid submissions.
  • Add Listing Flow module: MyListing Pro enhancements (checkout before listing, cover reposition, pending messages).
  • MyListing Club Add Listing guide: Real-world setup workflow in the mega guide.

​
Common Questions

  • Why do users see flipping cards instead of the form? The Add Listing widget lists more than one listing type and the URL has no listing_type parameter. Add only one type in the widget, or link to ?listing_type=your-type-slug.
  • Why is there no package step? Either Enable Paid Listings is off under Listings > Settings, or Enable paid listing packages is off for that type under Listing Types > General > Packages.
  • Why can’t a user submit a listing? Confirm they are logged in (if required), their role can submit under Theme Tools > User Roles, and the type is not a global listing type.
  • Why does the form look different from the rest of the page? Once a listing type is selected, MyListing moves the form outside the Elementor content area for layout reasons. The type-selection cards still use your Elementor page design.
  • Can users skip the preview step? Yes. The Submit listing button on the form skips preview. Most sites keep Preview as the default path.
  • What happens after checkout for a paid listing? The listing is created during the form steps. Checkout assigns the purchased package. The listing may stay pending until you approve it, depending on Listings > Settings.
  • How do users edit a published listing? From My Account > My Listings, if Allow editing of published listings permits it. Edits may require re-approval depending on that setting.
  • Is the Add Listing flow the same as claiming a listing? No. Claims start from an existing listing’s claim action and use the Claim Listing page. Add Listing creates new listings from scratch.