Related Listings

MyListing has two features that both show other listings. They are not the same.

Feature	How listings are chosen	Who controls it
Related Listings	Someone picks the exact listing or listings to connect	You set up the field. The listing owner (or an admin) chooses the links
Similar Listings	MyListing finds matches by type, category, tags, region, author, or other taxonomies	You turn it on under Single Page > Similar Listings

Use Related Listings when the relationship matters: company and jobs, place and events, and service and provider. Use Similar Listings when you want a “you may also like” section at the bottom of the listing page. Go to WP Admin > Listing Types, then edit the listing type that should store the connection. You work in more than one editor section:

Fields: Add and configure the Related Listing field
Single Page > Content & Tabs: Show connected listings as a tab or a content block
Preview Card: Show a related listing on search result cards
Search Forms: Let visitors filter Explore results by a related listing Adding the field is only the first step. Visitors will not see the connection until you also add a tab, block, preview card section, or filter that uses that field.

Edit a listing type and open Fields. You can add the field in two ways:

Preset fields: Click Related Listing. This uses the built-in field key related_listing.
Create a custom field: Choose Relational, then Related Listings. Use this when one listing type needs more than one relationship, such as a Venue that links both to Events and to Vendors. Click the field to edit it, then click Done and save the listing type.

Field Settings

These settings appear when you edit the Related Listing field.

Setting	What it does
Label	The name owners see on the add and edit listing form
Key	The internal field name. Shown only on custom fields. Must match on both listing types for two-way relations
Placeholder	Hint text in the picker. If empty, owners see Select listing
Description	Help text under the field
Related to	Which listing types can be selected. You can also choose WP Posts
Relation type	Whether this listing links to one or many others, and which side is the parent
Limit listing selections by author	Restrict the picker to the current author’s listings, or allow any author’s listings
Limit listing selections by status	Published is always allowed. You can also allow Pending approval, Pending payment, or Expired
Maximum number of selections allowed	For Has Many and Belongs to Many. Leave blank or `0` for no limit
Enable Package-Based Selection Limits	Set a different selection limit per listing package
Required	Owners must pick a related listing before they can submit
Show in submit form	Show the field on the public add and edit listing form
Show in admin edit page	Show the field when an admin edits the listing in wp-admin
Show in listing comparison popup	Include the field when visitors compare listings

The field also has a Need Help? button that opens the theme’s Related Listings tip.

Author and Status Limits

By default, Limit listing selections by author is set to Only listings that belong to the current author. A company owner can then attach only their own job listings, not someone else’s. Choose All listings that belong to any author when owners should link to listings they do not own, such as an event linking to a public venue. Published listings can always be selected. Turn on extra statuses if you want owners to attach a listing that is not live yet. Those pending listings stay hidden on the front end until they are published.

Relation Types

There are four relation types.

Relation type	How many listings can be chosen	This listing’s role
Has One	One	Parent
Has Many	Several	Parent
Belongs to One	One	Child
Belongs to Many	Several	Child

Has One and Belongs to One are for a single link. An event can belong to one venue. A job can belong to one company. Has Many and Belongs to Many are for multiple links. A company can have many jobs. A venue can host many events. Parent and child matter when you set up two-way relations. For a one-sided field, pick the type that matches how many listings the owner should select. The field default is Belongs to One.

Two-Way Relations

A two-way relation keeps both sides of a link in sync. Example: a Company can have many Job listings, and each Job belongs to one Company.

Edit the Company and assign jobs. Those jobs also get the Company as their related listing.
Edit a Job and assign a company. That Company also gets the Job in its list.

How to Set Up Two-Way Relations

Decide which listing type is the parent. In this example, Company is the parent and Jobs are the children.
In the Company listing type, add a Related Listing field. Set Related to to Jobs. Set Relation type to Has Many.
In the Job listing type, add a Related Listing field. Set Related to to Company. Set Relation type to Belongs to One.
If you used custom fields instead of the preset, set the same Key on both fields.
Save both listing types. If you use the preset Related Listing field on both types, the keys already match (related_listing).

One listing type can have more than one Related Listing field. Use the preset for the main relationship. Add extra custom fields under Fields > Create a custom field > Relational > Related Listings. Give each custom field a clear Label and Key. On the single listing page, each tab or block must point at the field it should use.

Link to WordPress Posts

The Related to setting includes WP Posts. Use this when a listing should link to a regular WordPress post instead of another listing, such as a case study, news article, or blog post. The theme’s own help text recommends Has One or Has Many for that setup. Owners pick related listings on the add listing and edit listing forms, as long as Show in submit form is on. The field is a search picker. For Has One or Belongs to One, they choose one listing. For Has Many or Belongs to Many, they can choose several, up to any selection limit you set. A few rules apply on the form:

The visitor must be logged in. Guests see: You must be logged in to add related listings.
The picker only shows listing types you checked under Related to.
Author and status limits still apply. Admins can set the same field when they edit a listing in wp-admin, as long as Show in admin edit page is on.

A field does not display itself. You choose how visitors see the connections. Go to Single Page > Content & Tabs and add the Related Listings preset tab. This tab loads a grid of preview cards for the connected listings. If there are many, the tab paginates. Tab settings:

Setting	What it does
Label	Tab name visitors see, such as Jobs, Events, or Hosted By
URL slug	Optional tab link appended to the listing URL
Hide tab if there are no listings	Hide the tab when this listing has no published related listings
Related Listings Field	Which Related Listing field to use
Listings order	Related field order keeps the order from the form. Recurring date field sorts by a Recurring Date field on the related listings
Recurring date field key	Which Recurring Date field to sort by. This appears only when Listings order is Recurring date field
Hide past events	Hide related listings whose recurring dates are in the past

Recurring date field is useful when a Place listing shows upcoming Events. The Recurring Date field must exist on the related listing type. If none are found, the editor shows: No recurring-date fields were found in the related listing field target types. A Related Listings tab does not use content blocks. The grid is built in. To mix related listings with other content, use a Related Listing block in the Profile tab or a Custom tab instead. In Single Page > Content & Tabs, edit the Profile tab or a Custom tab. Under Insert a New Block, add Related Listing. The block shows a compact list: logo (or featured image for a WP post) and name, each linking to the related item. Use a block when you want a short “Hosted by” or “Company” mention inside the main profile, and a tab when you want a full grid of cards. Go to Preview Card and add a footer section. Click Related Listing. Set:

Label: Optional text. You can use field placeholders. Older [[listing_name]] labels still work. They are treated as [[title]].
Use Field: Which Related Listing field to read On search results, maps, and listing grids, the card can then show the related listing’s logo and name. After you change preview cards, regenerate the preview card cache under Listings > Settings so the live site updates.

If you use MyListing Elementor Kit, the Listing Feed widget can query Related Listings, and Kit preview cards are used in Related Listings tabs and other listing grids.

Go to Search Forms > Advanced Form or Search Forms > Basic Form and add a Related Listing filter. Choose which Related Listing field the filter uses. Turn on Allow multiple selections? if visitors should select more than one related listing at once. Example: on a Jobs Explore page, visitors can filter jobs by company. On an Events Explore page, visitors can filter events by venue. The filter only works if listings actually have that Related Listing field filled in.

How the Pieces Fit Together

A practical Company and Job setup:

Company Fields: Add the preset Related Listing field. Set Related to to Jobs. Set Relation type to Has Many.
Job Fields: Add the preset Related Listing field. Set Related to to Company. Set Relation type to Belongs to One.
Company Single Page: Add a Related Listings tab labeled Jobs. Point Related Listings Field at the Company field. Turn on Hide tab if there are no listings.
Job Single Page: Add a Related Listing block in the Profile tab so each job shows its company.
Job Preview Card: Add a Related Listing footer section so job cards show the company name.
Job Search Forms: Add a Related Listing filter so visitors can search jobs by company. On the front end, a company owner adds jobs and assigns them to the company (or selects jobs from the company listing). Visitors then see those jobs on the company page and the company on each job and can filter the Jobs Explore tab by company.

Site idea	Typical link
Job board	Company Has Many Jobs. Job Belongs to One Company
Events directory	Place Has Many Events. Event Belongs to One Place
Service marketplace	Provider Has Many Services. Service Belongs to One Provider
Local guide	City Has Many Places. Place Belongs to One City
Editorial directory	Listing Has One or Has Many WP Posts for news or case studies

Helpful Tips

Set up both sides when the link needs to stay in sync. One field on one listing type is enough for a one-way mention. Use matching keys and opposite relation types for two-way editing.
Match the display to the field. A Related Listing field does nothing on the listing page until you add a tab, block, or preview card section that uses it.
Start with the author limit turned on. Only listings that belong to the current author prevents owners from attaching listings they do not own. Switch to any author only when that is the real workflow.
Use a tab for a grid and a block for a mention. The Related Listings tab shows preview cards. The Related Listing block shows a short logo and name list.
Rename listing type slugs with care. Related to store listing type slugs. After a rename, reopen the field and verify those checkboxes.
Pending links wait until publish. If you allow pending or expired listings in the picker, they appear on the front end only after they are published.

Quick Reference

I want to…	Go to…
Let owners connect listings	Listing Types > Fields, then add Related Listing
Keep both sides of a link in sync	Matching field Key, plus Has Many on the parent and Belongs to One on the child
Show a grid of connected listings	Single Page > Content & Tabs, then add a Related Listings tab
Show one related listing in the profile	Single Page > Content & Tabs, then add a Related Listing block
Show the host or company on a card	Preview Card, then add a Related Listing footer section
Let visitors search by related listing	Search Forms > Advanced Form or Basic Form, then add a Related Listing filter
Sort related events by date	Related Listings tab, set Listings order to Recurring date field
Auto-suggest other listings instead	Single Page > Similar Listings (a separate feature)

Where to Go Next

Listing Types: Fields, single page tabs, preview cards, and search forms
Listing Feeds: Place listing grids on any page, including feeds of related listings when you use Elementor Kit
Add Listing Flow: Where owners fill in the Related Listing picker
MyListing Elementor Kit: Custom cards and a Listing Feed query for Related Listings

Common Questions

Why is the Related Listing field empty or missing on the form? Confirm Show in submit form is on, the visitor is logged in, and Related to includes at least one listing type that has published listings the author is allowed to select.
Why can an owner not find another user’s listing? Limit listing selections by author is probably set to Only listings that belong to the current author. Change it to All listings that belong to any author if that is the intended workflow.
Why is the Related Listings tab missing? Either no published related listings exist, or Hide tab if there are no listings is on. Also confirm the tab’s Related Listings Field points at the correct field.
Why do two-way links not update the other listing? The field keys must match, Related to must point at each other, and the relation types must be opposite (for example Has Many and Belongs to One). Custom fields need the same Key on both listing types.
Can I have more than one Related Listing field? Yes. Use the preset plus custom Related Listings fields under Relational. Point each tab, block, footer section, or filter at the field it should use.
Do Related Listings and Similar Listings use the same settings? No. Related Listings come from a field the owner fills in. Similar Listings are an automatic match under Single Page > Similar Listings.
Can I link a listing to a blog post? Yes. Check WP Posts under Related to, and use Has One or Has Many.
Why did related listing pickers break after I renamed a listing type? The Related to checkboxes store the type slug. Re-check those boxes on every Related Listing field that pointed at the old slug.

Getting Started

Modules

MyListing 101