All Collections
Complete your marketplace setup
2. Add custom listing fields and filters
2. Add custom listing fields and filters

With listing fields you can determine what data is collected from suppliers and allow your customers to filter search results by it.

Vesa Vahermaa avatar
Written by Vesa Vahermaa
Updated over a week ago

We are now moving to the second step in the Setup checklist in Console: setting up custom listing fields and filters. Like elsewhere in the tutorial, you are encouraged to use settings and wording that are suitable for your own particular marketplace when going through the tutorial, in case you already have a good idea of what kind of marketplace you're looking to build.

A listing typically describes a product or service your providers are offering or a request posted by your customers. Listing fields refer to the fields the author of the listing needs to fill in when creating it.

Each listing has a set of default fields, like title, description, and price. When you set up your Listing type, which we configured in the previous tutorial, you determine the exact set of default fields that providers must fill out when creating a new listing.

In addition to the default fields, you can add a number of custom fields. These allow you to decide exactly what data is collected when a listing is created. You can also create search filters based on these fields.

Let's create some custom fields!

Go to Listings > Listing fields from the menu. By default, there is an example field. You can delete it or adjust it.

We will delete this example field in the tutorial and instead create the following new fields:

  • Brand. A single-select field to capture if the listed bike is made by Cube, GHOST, Giant, or someone else?

  • Accessories. A multi-select to indicate what accessories come with the bike. Is a bell, lights, lock, or mudguard included?

  • Bike rental rules. A free test field for sharing any specific instructions someone renting the bike should keep in mind.

Let's start with the bike brand. Click "Add a new listing field", and open the newly created field.

Field settings

Field label

Field label is displayed in the marketplace next to the form field.

Write "Brand"

Field ID

Field ID is a unique identifier that is stored in the data of the listing. While the label can be changed, you should not change the field ID after listings have been created with it, as the old listings will retain the old ID. Field ID should not contain spaces or special characters.

Write "brand"

Field type

Field type determines how the field works. In this case, we want each bike to have exactly one type, and it should be chosen from a predefined list of types.

Choose "Select one"

This field is mandatory

We want every bike to have a brand.

Check the checkbox

Field options

Here we define the different options for the bike type. Click open the first option.

Option label

Just like fields, options have labels.

Write "Cube"

Option value

Option value is a bit like Field ID: it's an identifier stored in the listing data. No spaces or special characters are allowed.

Write "cube"

Now, edit the second option. For the label, put "Diamant", and for the value, "diamant".

Let's add one more option. Click "Add a new option". Add "GHOST" as the label and "ghost" as the value.

Repeat the process for as many brands as you want to add.

Search settings

We can create a filter for our "Select one" field for the search page. Let's do that so people searching for GHOST bikes can filter out the rest.

Check the box

Filter placement

Most important filters should be made primary so they're always visible in our map layout, while secondary filters can be under the "More filters" submenu. Type is very important, so let's make it primary.

Choose "Use as a primary search filter"

Now, we have created our first custom listing field! Let's add two more.

The next one is "Accessories". This time, we want one bike to have multiple accessories. The field should not be mandatory, as some bikes might not have any amenities. There should be a search filter, but it can be under the "More filters" menu.

  • Field label: "Accessories"

  • Field id: "accessories"

  • Field type: "Select multiple"

  • Don't check "This field is mandatory"

  • Four field options: "Bell/bell", "Lights/lights", "Lock/lock", and "Mudguard/mudguard"

  • Search settings: Check "Add a filter to Search Page"

  • Filter placement: "Use as a secondary search filter"

Finally, let's add "Bike rules". This is just a freeform text field, for example, if the bike can't handle rough terrain and it should only be driven on flat road or terrain. It's optional: a bike doesn't need to have specific usage rules if it does well in all situations. For free text fields, we can't add a search filter, but we can decide whether a free text search should search the contents of this field. In this case, it doesn't make sense.

  • Field label: "Bike rules"

  • Field id: "bikeRules"

  • Field type: "Select multiple"

  • Don't check "This field is mandatory"

  • Don't check "Include this field in keyword search."

We're done! Remember to save the changes!

Next: Commission and minimum transaction size

Now we're happy with the listing fields and filters. Next, let's look into how to monetize your transactions.

Go to the next tutorial step to learn how to set your commission.

Did this answer your question?