All Collections
Setting up listing structure
How to add and edit listing fields
How to add and edit listing fields

Learn how to configure default and custom listing fields that are used during listing creation, customer discovery, and transactions.

Sharetribe avatar
Written by Sharetribe
Updated yesterday

Listing fields let providers add more information about their product, service, rental, profile, or offering when adding their listing to your marketplace. Listing fields can be turned into filters for customers to use when searching for listings. Most listing fields will be shown in the listing page when a user visits.

There are default listing fields and custom listing fields. Custom listing fields are fields you create that providers fill out during listing creation. Default fields are pre-configured listing fields associated with the transaction settings of a Listing type.

If you want to learn more about what listing fields are and how they work, please consult this article. This article focuses on explaining how to enable/disable default listing fields and how to create custom listing fields.

How to enable or disable default listing fields

Default listing fields are configured when creating your Listing type. Go to Console>Build>Listing>Listing types to create your Listing type.

Listing types contain multiple settings that you can learn more about in this article.

The "Default listing fields" section will display the list of default fields available with the chosen transaction process and whether they can be enabled or disabled. Greyed out fields indicates that the field must be enabled in this transaction setting.

Here is an example of a "Purchase" transaction setting with Delivery: pickup disabled, but Delivery:shipping and Payout details required before publishing enabled. Green checkmarks indicate the field is enabled. No checkmark indicates that the field is disabled. Disabled fields do not appear on the listing creation form.

A listing created with this Listing type will be available for shipping (but not pickup) when purchased and providers who create this listing for the first time will need to have their payout details added in order to publish the listing.

How to create custom listing fields

In Console, go to Build>Listings>Listing fields. You can add up to 100 listing fields.

To add a new field, click on the “+ Add a new custom field” link towards the bottom of the page.

Field settings

When creating the field, you have to set the Field label, the Field ID, and the Field type. Additionally, you can determine whether the field is mandatory and whether it is used as a search parameter or a filter.

  • Field label: This is the name of the field. Visible to all users of your marketplace in the listing form, the listing page, and potentially the search page.

  • Field ID: This is the unique identifier of this custom field. It cannot be changed once it has been created, but it won’t be shown to the users. However, it will be displayed in Console, within the listing card, so make sure you add something recognizable.

  • Field type: You have to choose the type of field that you want to use: Free text, Select one, or Select multiple. Learn more about how these field types work here.

Finally, determine whether the listing field is mandatory. If you select the option to make a field mandatory, listing authors will be required to fill out the free text field or select an option of the “Select” fields before being able to continue the listing creation process. If this option is not enabled, the field can be skipped.

Field options

When creating a “Select one” or “Select multiple” listing field, you will need to add at least one field option. When creating an “Option”, you need to define the Option label and the Option value.

  • Option label: The name of the option, displayed to users in your marketplace.

  • Option value: the unique identifier for the option within this field. It will not be displayed publicly in the marketplace but will be used in Console (and the backend) to identify this specific option, so make it something descriptive enough.

Listing type settings

Limit this field to specific Listing types

By default, each custom field is available in all your Listing types. If you enable this option, you can specify that the field is only available in some of them. For example, if you have two Listing types, "Offer a service" and "Request a service", you could use this feature to have two different field sets for these two Listing types.

If you enable the option Limit this field to specific listing types, you then need to add the IDs of the listing types that should have this field available. To add an ID, go to Listing types, copy the ID of a Listing type, go back to your field, click "+ Add a listing type ID", and paste the ID of your Listing type to the field that opens up.

Search settings

Include this field in keyword search

This option is available only to Free text type of fields. If enabled, the contents of this field will be searched against when users use keyword search. Keyword search returns results based on how well they match the listing title, description, and free text field (in this order of priority).

Add a filter to the search page

This option is available only for “Select one” or “Select multiple” field types. If enabled, a filter is added to the search page that can be used to find specific listings on the search page. All the options for filters (filed options) are available on the search page.

Filters based on “Select one” fields show any listing that includes at least one of the options. Filters based on “Select multiple” return listings that include all the selected options in the filter.

Filter placement

If you are using “Select one” or “Select multiple” listing field as a search filter, then you need to determine the filter placement.

A primary search filter is displayed before default filters on the Search page. Secondary filters appear after default filters. How this looks depends on the Search page layout you have configured.

In grid view, filters appear on the sidebar. The filters go top to bottom, primary, the default, then secondary filters.

In map view, filters appear on the top bar. Only primary and default filters are visible. Secondary filters are clicked into by pressing the “More filters” menu.

Did this answer your question?