All Collections
Sharetribe Go - Listings
Listing fields
Customize "post a new listing" form and add filters to a marketplace
Customize "post a new listing" form and add filters to a marketplace

Learn how to customise the "post a new listing" form and how to add filters to your homepage.

Sharetribe avatar
Written by Sharetribe
Updated over a week ago

To fit your project, you can adapt the listing creation form so that when your users post new listings, they can give great details about it. You can customize your listing creation form with listing fields.
It's also useful for visitors to allow this information to be filtered: you can create a filter from a listing field and display it on the homepage.

Create and edit listing fields

To create new listing fields, you should:

  • log in your marketplace as an administrator,

  • go to your Admin panel,

  • open the "Listings / Listing fields" page,

  • choose a field type from the "Add new field" link or edit an existing one.

  • configure it and save.

The listing field will be created immediately.

You can create different types of listing fields:

  • Text: listing author can add some free text and links in this field. If you add a link to the text field, it will automatically be transformed into a clickable link on the listing page.

  • Number: listing the author can add some numeric value in this field. You can decide to allow decimals or not and set up a minimum and maximum value.

  • Dropdown: listing author can select one value from a list you defined. (This is useful when a listing logically can have only one value for this aspect, e.g., size. A dropdown field creates a filter with "OR" logic, which means the person browsing can choose multiple values, and all listings that have any of chosen values are shown.)

  • Checkbox group: listing author can select one or more values from a list you defined. (This is useful when listing logically can have many values for this aspect, e.g., amenities or extra features. A checkbox group creates a filter with "AND" logic, which allows narrowing down the search as only the listings that have all the selected values are shown. )

  • Date: listing author can add a date via this field.

The listing field is added to the listing page and shows the value chosen during the listing creation form.

You can choose to make the use of this listing field mandatory or not.

Each listing field can be enabled, or not, for a category or subcategory. When creating or editing a listing field, you can choose which categories or subcategories should offer this listing field.

Create or hide, on the homepage, a filter based on listing fields

To help your visitors browse your marketplace, you can create filters based on listing fields.
Filters are available for the following listing field types: "Number", "Dropdown", "Checkbox group".
Filters are not available for the following listing field types: "Text", "Date".

To create or hide a filter based on a listing field on the homepage:

  • log in your marketplace as an administrator,

  • go to your Admin panel,

  • open the "Listings / Listing fields" tab,

  • open the listing field you want to manage,

  • check or uncheck the box "Display a filter based on this field on the homepage",

  • save.

Can I display only filters related to a particular category?

Yes. Initially, all the enabled filters are displayed on the homepage of your marketplace. Once you select a category, you will only see the filters related to that category or to a subcategory within that category. If you select a subcategory, you will only see the filters related to that subcategory.

Did this answer your question?