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 search for listings. Most listing fields will be shown on the listing page when a user visits.

There are two types of listing fields:

We discuss both listing field types and how they work in your marketplace below.

Default listing fields are those defined by the transaction settings of your Listing type. These fields facilitate or enable the particular type of transaction you hope to have. Therefore, different transaction settings have different default fields. You can learn about the different fields included in each transaction setting in this article about Listing types. Below, we detail how each default field works.

Default fields can be enabled or disabled. They are enabled or disabled in Console when configuring your Listing type.
​
Enabling a default field means that the field features in the listing creation form used by providers to create their listings. Enabled default fields are required to be filled in. Disabling a default field means that the information is not asked in the listing creation form.

The "Listing Title" is a required field that allows providers to write a brief title for their listing. This title is used throughout the marketplace, including in notification emails and on the search page. It is also searchable in keyword searches.

The Title field is always enabled for every transaction setting.

Description is a required field. This field lets providers write any amount of text they want. The Listing description is searched against a keyword search.

Here is an example of how the Title and Description are filled out in the listing creation form:

The description field is always enabled for every transaction setting.

The "Price" field is for entering the cost of the listing. This value is used in many places, including calculating the total cost of the transaction. When the Price filter is applied, listings are filtered based on this value.

The pricing unit is determined by the transaction settings. You can change the pricing unit label using Marketplace texts.

Here is an example of the Price field for a listing where bookings are made by the hour:

​
Price is always enabled when using Calendar booking or Purchase transaction settings. It can be enabled or disabled when using Free messaging transaction settings.

The location field asks the provider to enter an address for the listing. Whenever a location search is used, the listing location is searched against. Moreover, location information is displayed throughout the marketplace, including on the search page (in map view), on the checkout page, and on the order page.

Here is how Location fields look in the listing creation form:

Location services can be powered by Mapbox or Google Maps in your Live marketplace. If you plan to use the location field, you must configure either of these services in your Live environment. In your Test environment, Mapbox is configured so that you can try out location services when building. Learn more about configuring Mapbox or Google Maps here.

The location field is available when using the Calendar booking and Free messaging transaction settings. It can be enabled or disabled.

Availability asks providers to input when their listings can be booked. Customers, in turn, can book from this availability calendar. Learn more about availability management.

Here is how Availability fields can look in the listing creation form:

The availability field is available when using the Calendar booking transaction setting in the Listing Type.

The stock field is about defining what number is available for purchase. How the Stock field works depends on your Stock type selection. Please visit this article for a detailed review of how different Stock types work.

Here is how Stock fields can look in the listing creation form:

The stock field is available when using the Purchase transaction setting in the Listing Type.

There are two Delivery fields: pickup and shipping. Learn more about how shipping works.

Here is an example of how Delivery fields look in the listing creation form:

Delivery fields are available when using the Purchase transaction settings. You can enable both, disable both, or enable/disable only one.

The Images field allows providers to upload images and store them with the listing. Images are used in many places on the marketplace, including the search page, listing page, and order page. At least one image must be uploaded to publish a listing; it is not possible to publish a listing without an image.

Here is an example of how image upload fields look in the listing creation form:

The listing image can be landscape, portrait or square, and the maximum size is 20 MB and 3072 x 3072 pixels. Only one image can be uploaded at a time, and listing images are arranged in the order they were uploaded.

How listing images appear depends on the layout options you configured. You can learn more about these options and their consequences on listing appearance in this article.

The image field is always enabled for every transaction setting.

Payout details refer to the bank and personal information your marketplace requires to process payments on behalf of providers and pay out their earnings. You can determine if the payout details are required before a provider's listing is published or if the listing can be published without them. Payout details are always required before any purchase from the provider is made.

Here is an example of how payout details are asked through a pop-up that appears after a listing is submitted to be published:

Please visit this article for a detailed review of how payout details work.
​

Payout details required to publish a listing can be enabled or disabled when using Calendar booking or Purchase transaction settings.

Using the Marketplace Texts editor, you can modify the default fields labeled in your marketplace. Learn more about editing Marketplace texts here.

You add custom listing fields in Console > Build > Listings > Listing fields.
​

Providers fill each custom listing field during listing creation. The inputted information is shown on the listing page. Customers may also use it when filtering results or searching by keyword. We discuss how listing fields are used in the search below.

There are 3 types of listing fields you can add in Console: "Free text", "Select one" and "Select multiple".

This field allows providers to write text or numbers into it. It will be displayed as a text area in the listing creation form and as a block of text on the listing page. It can be used for many different pieces of information, and the information requested can be short or long.

Consider using the Free text field type when the information requested is open-ended and extensive or when you’d like to give the provider (listing author) more freedom to share about their listing.

This field allows providers to input a whole number (an integer). It can be positive or negative. You can set low and high limits. The max and min values are really large, respectively -9007199254740991 and 9007199254740991. It will be displayed as a number input field in the listing creation form.

On the listing page, all “Number” fields are displayed in a “Details” section.

Consider using the Number field type when the information requested is a number within limits, for example an age, a temperature, or a volume.

This field allows providers to select one attribute from a list of options when creating a listing. When you create this field, you have to define the options that will be available for listing authors to select. This field's options will be displayed as a dropdown in the listing creation form.

On the listing page, all “Select one” fields are displayed in a “Details” section. This field type is ideal when you want to give your providers a limited set of options, only one of which should be applied to the listing.

This field allows providers to select multiple attributes (as many as are available) from a list of options. To create this field, you have to define the list of options available to select. These will be displayed as checkboxes in the listing creation form.

On the listing page, the selected attributes are, by default, displayed among a list of all the possible attributes.

In the field settings, you can unselect the "Show unselected options on the listing page" checkbox.

When this setting is disabled, unselected options are not shown on the listing page. If all options are unselected, the field will not be displayed at all.

This field type is ideal for relatively homogeneous marketplaces where people are comparing options. It can be used to display a rental space’s amenities, additional services offered or available sizes. As with Select One, if the options cannot be confined to a specific list set, consider adding a Free text instead (or in addition).

Available when choosing “Select one” or “Select multiple” as Field type. The list of field options you input, besides being the options that a listing author can select when creating a listing, is also the potential list of filter options on your search page. You need to add at least one option.
​

You may limit a custom listing field to a particular Listing type, a particular category, or both. You may also limit them to multiple Listing types or categories.

When a listing field is limited to a category or Listing type, it only appears for listings using that type or category. Providers creating that type of listing or category will be asked to fill in this field; providers creating other types or categories will not.

Determining whether to limit to a Listing type or category depends on how you plan to use the custom field.

Listing types determine the type of transaction possible for a listing. For instance, if you have a marketplace for renting and selling bikes, you would need one Listing type to enable renting transactions and another to enable purchasing, as each transaction requires different capabilities to happen successfully.

Therefore, assign listing fields to different Listing types if the field is relevant only to particular type of transaction on your marketplace. You may want a custom field for stipulating "Rental rules" on your bike selling and renting marketplace. This would be limited to the Calendar booking listing type so that only listings that are about renting bikes include this "Rental rules" field.

On the other hand, categories classify what kind of thing is being listed. Different kinds of bikes are good examples of categories: gravel bikes, road bikes, hybrid bikes, fixed-gear bikes, touring bikes, and so on.

Assign listing fields to categories when the field is only relevant to a particular kind of listing. For example, a field for "Number of gears" would not be relevant to the fixed-gear category, so you would assign this listing field to every category except fixed-gear bikes.

A listing field's filter behavior is impacted when it is limited to a category. Before applying a category filter, customers see all fields on the search page. After applying a category filter, only filters created out of the limited listing fields are available for further filtering. This does not happen when a field is limited to a Listing type because customers cannot filter by Listing type.

Listing fields can be added, removed, and configured from Console > Listings > Listing fields. Please consult this article for detailed information on how to set up listing fields using the available options.

You can create up to 100 listing fields. Additionally, each "Select One" or "Select Multiple" field type can have up to 100 field options.

Listing fields can play a key role in your search experience. When considered in a search context, listing fields contain the information that customers can use to search. You decide if a field should be used in search, how it should be used, and where it should appear.

Customers have a variety of search options, including keyword search, location search, sorting, and filtering. Learn more about search on your marketplace.

Keyword search automatically searches against words found in listing titles and descriptions. In addition, you can add your “Free text” listing field to the keyword search parameter so customer queries search against the listing field. Learn more about keyword search.

Customers can also filter results on the search page. You can create custom filters from the “Select one” and “Select multiple” listing fields you made. “Select one”-based filters return any listings that have at least one of the selected options. “Select multiple”-based filters return listings with all the selected options. Learn more about listing filters.

Filter options display at the top of the search page or on its side, depending on your search page layout. Category filters and primary search filters show first and are always visible. Secondary filters are listed last on the search page or in a “More filters” menu, depending on your search page layout. Learn more about your search page layout options.