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 on 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.
Default listing fields: how to enable or disable them
Default listing fields are configured when creating your Listing type. Go to Console > Build > Listing > Listing types to create your Listing type.
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.
Custom listing fields: how to create and manage them
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. It is 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, Number, 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, every custom field you create appears on the listing creation form for providers to fill out. Limiting fields to a specific Listing type means that the listing field will only be shown to providers creating a listing in the specified Listing type.
Not sure whether to assign to Listing types or categories? The Listing fields overview article explains in detail when to use Listing types and when to use categories to suit your use case.
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.
Category settings
Limit this field to specific categories
By default, every custom field you create appears on the listing creation form for providers to fill out. Limiting fields to a specific category means that the listing field will only be shown to providers creating a listing in the specified category.
If you enable the option Limit this field to specific categories, you then need to add the IDs of the categories that should have this field available. To add an ID, go to Listing categories, copy the ID of the category, 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 "Number", "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. All the filter options (field options) will be shown 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 "Number", "Select one" or "Select multiple" listing field as a search filter, then you need to determine the filter placement on the search page.
A primary search filter is displayed after filters based on categories, but filters based on default fields. Secondary filters appear after default filters.
In grid view, filters appear in the left sidebar. In map view, filters are placed above the listing results grid to the left of the map. Only category, primary, and default filters are visible. Secondary filters are clicked into by pressing the “More filters” menu.