Listing fields
Custom listing fields let you collect specific information about listings in addition to the default fields. Build fields like "Brand", "Condition", "Year", or "Bedrooms" — with no code and no limit on how many you add. Searchable fields can also power keyword search, storefront filters, and sort options.
Open the Listing fields page
- Go to Sites in the admin panel
- Click on your site to open its Home page
- In the sidebar, expand Build → Listings and click Listing fields
Permissions
Only team members with permission to update a site can manage listing fields. See Account settings for team roles.
Field types
Each field has one of six types:
| Type | What it collects | Notes |
|---|---|---|
| Single line text | A short text value | Limited to 70 characters |
| Long text | A longer text value | Limited to 5,000 characters |
| Number | A whole number | Optional minimum and maximum limits |
| Select | A single choice from a dropdown | You define the options |
| Select multiple | One or more choices via checkboxes | You define the options |
| Video | A YouTube URL | Embedded automatically on the listing page |
Select and Select multiple fields require at least one option. Video fields accept any YouTube URL — the video ID is extracted automatically and embedded privacy-friendly via the listing page.
Access levels
Every field has an access level that controls who fills it in and where it appears.
Public
Public fields are filled in by users while creating or editing their listing. They always appear on the listing page. For public fields you can:
- Mark the field required — users must fill it in to post the listing
- Add help text — guidance shown to users while they fill in the field
Metadata
Metadata fields are filled in by team members only, from a dedicated edit screen on each listing (see below). They're hidden from visitors by default. Toggle Show on listing page to display a metadata field's value to visitors on the storefront.
When to use metadata
Metadata is ideal for internal notes or admin-managed attributes — inventory IDs, source tags, staff-assigned condition grades, or anything you don't want users to fill in themselves.
Search settings
Fields can do more than collect information — they can also power search. Each field type supports different search capabilities:
| Field type | Keyword search | Storefront filter | Sort option |
|---|---|---|---|
| Single line text | Yes | — | — |
| Long text | Yes | — | — |
| Number | — | Yes (range slider) | Yes |
| Select | — | Yes | — |
| Select multiple | — | Yes | — |
| Video | — | — | — |
Video fields have no search settings. The Search settings section appears for every other type when you create or edit a field.
Include in keyword search
Available for Single line text and Long text fields. When enabled, the storefront search box matches against this field's values in addition to listing titles and descriptions. See Search & filtering.
Enable for search
Available for Number, Select, and Select multiple fields. When enabled:
- Team members can filter listings by this field in the admin panel, using the filter flyout on the Manage → Listings page
- The field becomes eligible to appear as a storefront filter and (for Number fields) a sort option
Storefront filter placement
Once a field is enabled for search, choose where its filter appears on the browse page:
| Placement | Where it shows |
|---|---|
| Not a storefront filter | Hidden from the storefront (admin filtering only) |
| Primary filter | Shown first, before the default filters |
| Secondary filter | Shown after the default filters |
Each field type renders an appropriate control — Select fields become a list, Select multiple fields become checkboxes, and Number fields become a range slider.
Storefront sorting
Available for Number fields. Choose whether the field appears as a sort option, and where:
| Placement | Where it shows |
|---|---|
| No sort option | Not shown on the storefront |
| Primary sort option | Shown above the default sorting options |
| Secondary sort option | Shown below the default sorting options |
When a field is a sort option, pick the directions visitors can use — Low to high, High to low, or both.
Limit a field to specific categories
By default, a field applies to every listing on your marketplace. You can limit a field to one or more categories so it only appears for listings in those categories.
For example, a "Year" field might be limited to the Vehicles category, while a "Bedrooms" field is limited to Real Estate. Leave the category limit unchecked and the field shows for every listing.
On the storefront, public fields adapt automatically as users pick a category while creating their listing — only the relevant fields appear.
Creating a field
- Click Add field
- Enter a Field name (e.g. "Condition")
- Choose an Access level — Public or Metadata
- Choose a Field type
- Configure any type-specific options:
- Number — set an optional minimum and maximum
- Select / Select multiple — add at least one option, and reorder options by drag-and-drop
- For Public fields, optionally add help text and mark the field required
- For Metadata fields, optionally toggle "Show on listing page"
- Configure the Search settings for the field type (see above)
- Optionally limit the field to specific categories
- Click Add
Reordering options
For Select and Select multiple fields, drag options by their grip handle to reorder them. The order you set is the order users see them.
Select multiple: show or hide unselected options
For Select multiple fields, you can choose whether to show unselected options on the listing page. When disabled, only the options a user selected appear on the listing page. If the user selected nothing, the field isn't displayed at all.
Editing and deleting fields
Click the ellipsis (…) button next to a field and select Edit to change any of its settings, or Delete to remove it.
Deleting removes saved values
When you delete a field, any values users or team members have saved for that field are removed from listings. This can't be undone.
Reordering fields
Drag a field by its grip handle to reorder it. The sort order controls the order fields appear in the listing form and on the listing page.
Filling in metadata
Metadata fields don't appear on the public listing form. Instead, team members fill them in from a per-listing edit screen:
- Go to Manage → Listings in the site sidebar
- Find the listing and open it
- Edit the metadata fields and save
Only team members with permission to manage the site can edit metadata.
How fields appear on your storefront
Fields show up in several places on your storefront:
- Listing form — public fields appear when users create or edit a listing, filtered by the selected category
- Listing page — public fields always show, and metadata fields show when "Show on listing page" is enabled. Video fields render as an embedded YouTube player, and Select multiple fields show only the selected options (unless you've enabled showing unselected ones)
- Browse page filters — searchable fields with a storefront filter placement appear in the filter sidebar, rendered by their type
- Browse page sorting — Number fields set as a sort option appear in the sort menu
Fields and categories work together
If a field is limited to a category that a listing doesn't belong to, that field won't appear on the listing form or page — even if it has a saved value. A field limited to a parent category also applies to its subcategories. See Categories to manage your category structure.