Skip to main content
MyListing Pro includes a Listing Type Editor module that greatly enhances the overall experience when building and managing listing types.
MyListing Pro provides extra custom fields as part of the MyListing Fields module.
MyListing Pro provides extra styling for Quick Actions within the MyListing Tooltips module.
MyListing Club provides pre-configured listing types to speed up your build.
MyListing Club provies pre-configured product packages to speed up your build.

​
What is a Listing Type?

A listing type is the blueprint for a specific kind of listing on your site. Think of it this way:
  • A listing is one entry on your site (one restaurant, one event, or one job post).
  • A listing type defines what that entry looks like, what information it collects, and how visitors find and view it.
If you run a directory with restaurants and events, you would typically create two listing types: one for restaurants and one for events. Each type can ask for different details, show a different page layout, and use different search filters. Every listing belongs to exactly one listing type. The listing type controls almost everything about how that listing behaves on your site.

​
Where Do You Manage Listing Types?

Go to WP Admin > Listing Types. From there, you can:
  • Create a new listing type
  • Edit an existing one
  • Duplicate one as a starting point
When you edit a listing type, you work in five main sections. Each section controls a different part of the visitor and listing owner experience.

​
The Five Main Sections

​
General

This area is where you set the basics: name, icon, and site behavior. General (labels and links)
  • Icon: Shown in menus and the Explore page. You can pick a font icon or upload an image.
  • Singular name: What one listing is called (for example, “Business” or “Event”).
  • Plural name: What many listings are called (for example, “Businesses” or “Events”).
  • Permalink: The word used in listing URLs (for example).
Packages If you sell listing plans through WooCommerce, this section is where you choose which plans apply to this listing type. You can turn paid packages on or off per type, so restaurants might be free while featured events require payment. Claim Form If your site enables listing claims, choose which fields appear when someone tries to claim a listing of this type. Reviews Control how reviews work for this type:
  • Turn star ratings on or off
  • Allow half-star ratings (1.5, 2.5, and so on) or whole stars only (1 through 5)
  • Add rating categories (for example, “Food,” “Service,” “Atmosphere”)
  • Allow photo uploads in reviews
  • Allow the listing owner to leave reviews on their own listing
Expiry Rules Set rules for when listings of this type should expire or need renewal. Schema Add structured data (schema markup) to help search engines better understand your listings. Useful for SEO. Other
  • Disable slug update: Keeps the URL the same even if the listing title changes.
  • Global listing type: Creates a special type used only on the Explore page to search across all other types at once. You should only have one global type, and it should not be used on the Add Listing page.

​
Fields

Fields are the questions you ask when someone adds or edits a listing. The answers become the listing’s content. Used fields (left side) These are the fields that appear on the Add Listing and Edit Listing forms. Drag to reorder. Click a field to change its settings. The Title field is always required and cannot be removed. You can customize the rest. Preset fields (right side) Predefined fields you can add with one click: Custom fields (right side) Build your own fields when presets are not enough:
  • Input: Text, Textarea, Rich text editor, Password, Date, Recurring date, Number, URL, Email, File upload, General repeater
  • Choice: Dropdown, Multi-select, Checkboxes, Radio buttons
  • Relational: Related listings, Product select, Product multi-select
  • UI: Form heading (to break the form into sections)
Tips for fields
  • Use Form Heading fields to split long forms into clear sections (“Contact Details,” “Photos,” and so on).
  • For Category, Region, Tags, or custom taxonomies, you can change how they appear: single dropdown, multi-select, hierarchy tree, or checklist.
  • Custom taxonomies you create under Listings > Taxonomies show up here as available fields.
  • Some fields support package visibility, so certain fields only appear for users on specific paid plans.

​
Single Page

This section controls what visitors see on the individual listing page. Cover style Choose whether the top of the page uses a single cover image or a photo gallery. Cover details Pick which information appears in the header area (title, tagline, rating, location, and so on). Quick Actions Buttons visitors can tap right away, such as:
  • Get directions
  • Call now
  • Send a message
  • Leave a review
  • Bookmark
  • Share
  • Claim listing
  • Report
  • Visit website
  • Send email
  • Display a field value
  • Custom link
Content and Tabs This section is where you build the main body of the listing page. Add tabs such as:
  • Profile: The main content tab (most common)
  • Reviews: Customer reviews
  • Related Listings: Connected listings
  • Store: WooCommerce products linked to the listing
  • Bookings: Booking features (if enabled)
  • Custom: A tab you name yourself
Inside each tab, you can add content blocks that display field data. Blocks use placeholders, such as[[job_description]] to pull in data from the fields you set up earlier. Similar Listings Show related listings at the bottom of the page. You can match by type, category, tags, region, or author and control how many appear.

​
Preview Card

The preview card is the small listing tile visitors see in search results, maps, and listing grids. Preview Card
  • Template: Default, Alternate, or List view layout
  • Background: Use the cover image or gallery images
  • Head buttons: Small labels on the card (for example, category or price range)
  • Info fields: Extra details shown on the card
  • Footer sections: More data at the bottom of the card
  • Map marker: Which category controls the map pin style
Quick View The popup that opens when someone clicks Quick View on a card. You can customize its layout and map style. Important: After you change the preview card design, you may need to regenerate the preview card cache under Listings > Settings so changes appear on the live site.

​
Search Forms

This section controls how visitors search and filter listings of this type on the Explore page and in search forms. Advanced Form The full filter panel is located in the sidebar on the Explore page. Add filters such as:
  • Keyword search
  • Text search on a specific field
  • Number range
  • Location
  • Distance (near me)
  • Dropdown
  • Date
  • Recurring date (events)
  • Checkboxes
  • Related listing
  • Sort order
  • Section heading (visual divider)
  • Open now (based on work hours)
  • Star rating
Basic Form A simpler search form, often used in the site header or on a homepage. The same filter types are available. You can also set which page the form submits to. Listing Order Define how results can be sorted (newest first, highest rated, nearest, and so on) and which sort is the default. Explore Tabs Sidebar tabs on the Explore page, such as:
  • Filters (the search form)
  • Categories
  • Regions
  • Tags
  • Any custom taxonomies you created

​
How the Pieces Fit Together

Here is the flow from setup to live site: Listing Type
  • Fields: What owners fill in when they submit
  • Single Page: How that information is displayed
  • Preview Card: How listings look in search results
  • Search Forms: How visitors find listings
  • General: Names, reviews, packages, and other rules
A practical example for a restaurant listing type:
  1. Fields: Title, Description, Location, Category, Logo, Cover, Gallery, Work Hours, Price Range, Menu (repeater)
  2. Single Page: Cover with gallery, Quick Actions for Call and Directions, Profile tab with Description, Menu block, Work Hours block, and Location map
  3. Preview Card: Cover image, category label, price range, and rating
  4. Search Forms: Keyword, Category, Location, Open Now, and Rating filters
  5. General: Singular name “Restaurant,” reviews enabled with star ratings

​
Common Listing Type Setups

You can start with one listing type and add more later. Duplicating an existing type is usually faster than creating a new one.

​
Helpful Tips

  • Start simple. Add only the fields you truly need. You can always add more later.
  • Match fields to display. A field only appears on the listing page if you add a content block that uses it. Setting up fields and the single-page layout are closely related to each other.
  • One global type at most. The global listing type is only for cross-type searches on the Explore page. Do not use it for regular listings.
  • Test the full journey. After editing a listing type, try adding a test listing, searching for it on the Explore page, and viewing its single page. This catches missing fields or blocks quickly.
  • Paid plans are per type. Under General > Packages, you choose which WooCommerce listing plans apply to each type. Different types can have different pricing or no pricing at all.
  • Revisions are saved automatically. MyListing keeps a history each time you save a listing type. If you use the Listing Type Revision Viewer, you can read those changes in plain language before rolling back.

​
Quick Reference: Editor Sections

​
Listing Type Slugs

A listing type slug is the internal name that MyListing uses to identify a listing type. Think of it this way:
  • The title is what you see in the admin list (for example, “Restaurant”).
  • The singular and plural names are the labels visitors and owners see (for example, “Restaurant” / “Restaurants”).
  • The slug is the critical key behind the scenes (e.g., restaurant).
Every listing stores that slug as its link to a listing type. MyListing then uses the slug to load the right fields, single-page layout, preview card, search filters, packages, and more. If the display name is the label on a filing cabinet drawer, the slug is the exact folder code stamped on every file inside it. Change the code without updating the files, and the cabinet can no longer find them.

​
Slugs Are Easy to Mix Up

MyListing uses several “slug-like” settings. They are not the same thing.
Disable slug update only freezes an individual listing’s URL when its title changes. It does not protect or rename the listing type slug.
  • If you have the Show Listing Type Slug Column enabled in MyListing Pro, simply click on the Listing Type menu item in the WordPress dashboard, and you’ll see a column with the name of the slug for each listing type.
  • Another option is to edit each listing type and enable Slug under Screen Options.
MyListing treats the slug as the permanent key for a listing type. It is not only a pretty URL fragment.When a listing is created or saved with a type, MyListing stores that type’s slug on the listing. Later, the theme uses that same slug to look up the listing type and decide:
  • Which fields appear on Add Listing and Edit Listing
  • How the single listing page is built
  • Which preview card and Explore filters apply
  • Which paid packages are valid for that type
  • How Explore, listing feeds, quick search, similar listings, and dashboard filters group results
That is why a small slug change can feel like a large site break. The type editor may still look fine, while thousands of listings still point at the old key.
Direct links use the listing type slug:https://yoursite.com/add-listing/?listing_type=restaurantIf that slug no longer matches a published listing type (or the type is not included in the Add Listing widget), users may see the wrong step, flipping type cards, or a failed flow.

​
Elementor Widgets

Widgets such as 27 > Explore Listings, 27 > Add Listing Form, and 27 > Basic Search store the listing types you selected by slug. After a rename, reopen those widgets and confirm each type is still selected.Explore tabs, type dropdowns, and filters are keyed by slug. Queries also match listings whose stored type meta equals that slug.Package limits and validation are tied to the listing type slug. Renaming a type without updating package settings can make limits or package checks stop lining up with the type you expect.In Listing Types > Fields, a Related Listings field stores which types it can connect to by slug. After a rename, review those “Related to” checkboxes.

​
Global Listing Type Settings

If you use a global listing type with advanced type selection, those choices are also stored by slug.Under WP Admin > Settings > Permalinks, the listing base can include %listing_type%. That tag uses the listing type Permalink setting when set; otherwise, it uses the listing type slug. Changing either can change live listing URLs.For more flexible URL structures and better SEO, be sure to check out the Taxonomy Permalinks feature of MyListing Pro.
MyListing does not automatically rewrite every listing’s stored type when you change a listing type’s WordPress slug. The type post can move to a new slug while listings keep pointing at the old one.
Treat a slug rename like a data migration, not a label edit.
  1. Note the old slug and the new slug.
  2. Update the listing type’s WordPress slug and save.
  3. Update every listing that still stores the old slug so it stores the new one.
  4. Re-check Elementor widgets (Explore, Add Listing, Basic Search, listing feeds, and any custom deep links).
  5. Re-check Related Listings fields, global listing type advanced settings, and package limits for that type.
  6. Visit Settings > Permalinks and save (even without changes) so rewrite rules refresh.
  7. Test one listing of that type on the single page, Explore, Add Listing, and My Account edit flow before you assume the site is healthy.
  8. Add redirects if public listing URLs changed because of Permalink / %listing_type%.
MyListing Pro can bulk update listings from one listing type key to another under Listings Admin with Reassign Listings to a Different Listing Type. That is the practical way to repair listings after a slug rename or type merge.Without a bulk tool, you would need to edit listings one by one (or run a careful database/snippet update), which is easy to get wrong on a live directory.
  • Pick the slug once, early. Set it before you import or publish a large batch of listings.
  • Prefer labels over keys. Use Singular / Plural for branding. Keep the slug stable and boring.
  • Use Permalink for URL wording. That is the setting meant for %listing_type% in listing URLs.
  • Audit widgets after imports. Starter sites and imported types bring their own slugs. Confirm Explore and Add Listing still point at the types you intend.
  • Keep marketing links explicit. Share ?listing_type=your-slug links so users skip the wrong type-selection step.
  • Do not confuse listing slugs with type slugs. Fixing -2 on a listing URL is unrelated to renaming a listing type.