Search helps users find listings on your marketplace. It’s usually the first action customers take, so creating an easy and intuitive search experience is key to the success of your marketplace.
By default, both logged-in and anonymous users can browse and search listings on your marketplace, but only logged-in users can start transactions.
Users can search by keyword, location, or both. You can also further enrich the search experience by adding categories, custom fields, and by limiting custom fields to specific categories.
Search bar
The marketplace search bar supports keyword and location searches. You can configure your search type in Console > Build > Listings > Listing search. You can also decide to show the search bar in the top bar only on some pages (learn more here).
Here is an example of a search bar with location search configured as the search type:
Tip: You can change the placeholder text in a search bar using Console > Build > Content > Marketplace texts. Find the “TopbarSearchForm.placeholder” and the “LocationSearchForm.placeholder” keys and replace the text values there for your own. The default text is “Search listings…”. Learn more about Marketplace texts.
Location search
When location search is enabled, users can find listings by entering a place such as a country, city, street or postal code. You can also enable keyword filtering when location search is enabled, allowing users to combine location and keyword search.
Keyword search
Keyword search lets users find listings by entering words or phrases. When enabled, it checks the listing title, description, and any 'Free text' fields you’ve included in keyword search. The search requires an exact match with the text(s) entered.
Search as a CTA in a page section
In any section of a content page created with the Pages feature, you can enable Search as the section's call to action. Doing so allows you add one or more of these search fields:
Main category
Keyword search
Location search
Date range
Here is an example of a landing page with Search as CTA in the Hero section:
Search page
The search page is where open listings are returned by the search. Users can further refine their search results using filters and sorting on the search page.
Here is an example search page with a filter based on a category enabled:
Your marketplace search page is always located at yourdomain.com/s. The “/s” in the URL indicates the search page.
How to create different search pages
When users input a search parameter on the search page, the parameter is stored in the URL address of the search page. Filters, keywords, or locations are examples of search parameters. "yourdomain.com/s" is the path of the search page with no search parameter inputted; all open listings are shown there.
One or many parameters can be stored in a search page URL. Opening up a webpage with that same URL path will open up a search results page with the same search parameters inputted. In other words, the URL of the search page stores the searched-for parameters.
Any field or filter on your landing page will be stored in the address path of your search page. It is particularly useful with listing type, category, and location searches.
A search page without any search parameter exists at
/s
A search page with a category parameter can look like this:
/s?pub_categoryLevel1=main
A search page with a listing type parameter can look like this:
/s?listingType=daily-variation
You can use this mechanism to create search pages with results for specific or desired parameters. For instance, you can direct users to view results only in a particular geographic area or results in a particular category. You can combine these to create a search page for results in a particular area and in a particular category.
There is no limit to the amount of parameters that can be stored in the URL of the search page.
Here are some ways you can use this technique:
Limit location search to particular locations
Build pre-filtered search pages by category
In marketplaces with both regular and reverse transactions, build separate search pages for supply discovering demand and for demand discovering supply
Filters
Filters can be created from:
Listing types, listing categories, and default listing fields, configured Console > Build > Listings > Listing search
Custom listing fields, configured in Console > Build > Listings > Listing fields
Default fields are defined by the transaction settings of a Listing type. In other words, they are fields that enable a specific type of transaction. Some are optional while some are required. Custom fields, on the other hand, are fields you create and configure to let users share more details about their listing.They also help tailor the search experience on your search page.
Sorting
Listings are shown in the order they were created: more recent listings are shown ahead of older listings. Users can choose to sort by oldest listings first.
Users can also sort results by price (highest or lowest first). When searching by keyword, users can sort results by relevance to the keyword. Location searches are automatically sorted by distance to the searched-for location with nearer listings coming first.
Layout
The search page layout (where elements are placed and what elements are shown) is configurable. When configuring a custom filter, you can choose whether it shows as a primary filter or secondary filter. Primary filters feature more prominently. Learn more about filter placement.
The search page can be laid out in grid view or map view. Learn more about these layout options.
Build your search around listings
Your marketplace search engine queries and returns open listings from your marketplace database. Listings that are closed, pending approval by the admin, drafted, or deleted are not returned during a search.
User profiles, or the account page of a particular user account, is not searchable. User profiles, in other words, do not appear on the search page. User profiles can be accessed by pressing "View profile" button at the bottom of the listing page or through a direct link. User profile URLs are always domin.com/u/random-letters-and-numbers
. The "u/random-letters-and-numbers
" points to the specific user profile.
For marketplaces where the focus is on discovering people (e.g., hiring industry professionals), you should configure listings to function and look like like profiles. This allows them to be searchable, filterable, and sortable like regular listings.
Tip: Use different tools to configure listings to look like profiles. Start by configuring the appropriate Listing type. Then, build the custom listing fields you want to feature on the profile listing, and choose which should become filters. Organize your listings into categories. Finally, tailor your marketplace texts, changing generic labels like "Listing title" or "Description" to terms more suitable to what your marketplace listings are all about. Learn more about configuring listings in the Help center.