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 fields cannot be disabled in this transaction setting.
Here is an example of a "Purchase" transaction setting with Delivery: pickup disabled, but Delivery: shipping, Images 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 name, the Field ID, the Field type, and the Access level.
Field name: 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: The unique identifier of this custom listing field. It cannot be changed once it has been created and won't be shown to users, but it will be displayed in Console within the listing card, so make sure you add something recognizable.
Access level: Determines who can fill in the field and how it behaves:
Public: the field is filled in by the provider when creating a listing. You can make this field mandatory, meaning providers must fill it in before being able to publish their listing.
Metadata: the field is filled in by the operator in Console and cannot be edited by the provider. This field cannot be made mandatory. Learn more about metadata.
Field type: The type of field you want to use: Single-line text, Long text, Number, Select one, Select multiple, or Video. Learn more about custom listing field types.
Finally, you can also add a help text, which is displayed to users below the field. This can be used to display additional information explaining what the custom field is about.
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 Long and Single-line 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 text fields (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 use "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.
Add a sorting option to the search page
If you use the "Number" listing field type, you can enable a sorting option on the search page, allowing customers to sort listings by that field. Note that if you enable sorting, the option to add a filter to the search page will not be available, as the two cannot be used together.
You have two placement options for sorting:
Use as a primary sorting option: Displayed above the default sorting options on the search page.
Use as a secondary sorting option: Displayed below the default sorting options on the search page.
You can also enable a sorting order, Low to high, High to low, or both options.