Featuring listings on your landing page is an effective way to highlight your marketplace's best offerings, attract customers, and drive transactions for your provider. You can create a featured listings section on your landing page with the Pages feature by using the Listings section template.
How to add featured listings
To add a featured listings section to your landing page, follow these steps:
In your Console, go to Build → Content → Pages, then click on landing-page.
Click + Add a new section.
Name the section "Featured listings" or a name that helps you identify its purpose.
Select Listings as the Section template. This allows showing a collection of up to 10 listings. 1-4 listings are visible at a time and the rest can be revealed by swiping or scrolling.
Select the number of columns, 3 or 4. This determines how many listing cards are visible at a time before swiping
Choose your listing selection:
All listings: displays all listings, with the newest ones shown first.
Specific listings: displays a filtered subset of listings based on a listing search query (see the Listing Search Query section below for details).
The featured listings will automatically appear, displaying their thumbnail image, price, title, and listing author. This follows the same display format as the search page. You can create up to 10 featured listings sections on any content page created with Pages.
Note: We recommend not placing the featured listings section at the top of your landing page. The featured listing section has a brief loading delay each time the landing page is opened, which means users may see a loading state before the listing content appears.
Listing search query
A listing search query is a precise request sent to your marketplace's database to retrieve a specific set of listings. Sharetribe Core stores information about each listing, which can include its category, custom fields, price, location, and more, and the query filters this data to return only the listings that match your criteria. When used in the featured listings section, the section automatically populates with listings that match the query.
The following listing data can be used to build a search query:
Listing ID
Listing category
Listing type
Listing fields
Location
Price range
Keywords
Sort order: Newest, Oldest, Highest price, or Lowest price
How to generate a search query
There are two ways to generate a listing search query.
Option 1: Using the Console
Go to Manage → Listings in your Console.
Use the Filter functionality to filter by any combination of:
Listing category
Listing type
Listing fields
Price range
You can also type keywords into the search bar to include keywords in the query.
Click Copy search query to copy the generated query.
Paste the query into the Listing search query field in Pages.
Option 2: Using the Query Builder Tool
Use the query builder tool to generate the query. You can start from a base query generated with Option 1, or build one from scratch by filling in the available filtering and sorting options.
Use this method if you need to filter by location, specific listing IDs (to feature hand-picked listings), or sorting options. These filters cannot be generated from the Console and require the query builder tool.
Using Listing IDs in your query
If you decide to handpick specific listings to feature on your landing page (or any other page), be aware that listing IDs are always environment-specific, meaning listings in your Test environment are separate from those in your Live environment.
If you create a featured listing section using Test listing IDs and then copy your changes to Live, those Test IDs will carry over to Live, but since Test listings don't exist in the Live environment, no listings will be shown.
To avoid this, always use Live listing IDs when building your query, even if you are currently working in the Test environment and marketplace. This ensures the query works correctly once copied to Live. As a result, your featured listings section may show a "We couldn't find any listings for this section" message; this is expected behavior and not a cause for concern.