Documentation menu

Listings

Taxonomies

Categories, types, statuses, locations, features, and labels — how listings are classified and filtered.

Six taxonomies classify a listing. Together they drive the archive filters, the browsable URLs, and which editor fields appear.

TaxonomyAdmin menuStructurePer listing
Property CategoriesProperties → Property CategoriesHierarchicalOne primary
Property TypesProperties → Property TypesFlatOne
Property StatusesProperties → Property StatusesFlatOne
LocationsProperties → LocationsHierarchicalOne branch
FeaturesProperties → FeaturesFlatMany
LabelsProperties → LabelsFlatMany

Property Categories

The top-level split, and the most consequential choice in the editor: Residential, Commercial, Land. It decides which fields the listing editor shows and which types and features are offered.

Three terms ship by default. You can rename them, but keep the set small — each category is a different field model, not a marketing segment.

Category terms accept an Icon from the built-in icon registry, used in filters and search suggestions.

Property Types

The subtype: Apartment, Villa, House, Penthouse, Studio, Duplex, Townhouse, Land plot, Building plot, Agricultural land, Commercial plot, Office, Shop, Retail unit, Warehouse, Hotel, Restaurant, Building — eighteen terms out of the box.

Each type has a Show for categories setting so the editor offers only sensible options: Warehouse under Commercial, not under Residential. Set it when you add your own types, or they will not appear in the picker.

Types also carry an Icon and can be routed to a different single-listing layout — see Single property layouts.

Property Statuses

Sale versus rent. Ships with For sale and For rent, which is what the Any/Buy/Rent tabs in every search bar map onto.

Locations

A hierarchy: country → city → district. Assign the deepest term that applies — the listing then appears under its city and country archives too.

Location terms have a Cover image used by the Featured Locations block and other location cards.

The demo kit seeds a European tree (Spain, Portugal, United Kingdom, Netherlands with their cities and districts). Replace it with your own market before launch — location terms are the backbone of location search.

Features

Amenities, as chips in the editor. Forty-four terms ship, grouped by intent:

GroupExamples
Indoor & outdoorBalcony, Terrace, Garden, Storage room, Fireplace, Furnished
Building & servicesElevator, Parking, Security, Concierge, Video intercom, Gated community
ViewsSea view, City view, Mountain view, River view, Park view
Comfort & systemsAir conditioning, Underfloor heating, Solar panels, Double glazing, Smart home, Fiber internet
Wellness & lifestylePool, Gym, Sauna, Rooftop access, Pet friendly, Wheelchair accessible
Land utilitiesMains water, Electricity at boundary, Sewer connection, Natural gas

Like types, features have Show for categories, so land utilities do not clutter an apartment editor.

Labels

Marketing badges printed on cards and the listing page: New listing, Featured, Price reduced, Open house. Each term has Badge background and Badge text colors with a live preview.

Two labels are wired into behavior:

  • Featured backs the Featured filter chip on the archive.
  • Open house is applied and removed automatically when a listing’s open-house schedule is set — do not manage it by hand.

Browsable URLs

Every taxonomy has its own archive, and they accept the browse view segments:

/property-category/residential/
/property-type/apartment/
/listing-type/for-rent/
/property-location/london/
/property-feature/sea-view/
/property-label/featured/

/property-location/london/map/
/listing-type/for-rent/rows/page/2/

These pages render with your property archive template, filter bar included.

Adding your own terms

  1. Open the taxonomy under Properties.
  2. Add the term, with a parent where the taxonomy is hierarchical.
  3. For types and features, set Show for categories — otherwise they never appear in the editor.
  4. Add an Icon or Cover image where the taxonomy supports one.

Filter chips only list terms that have listings attached, so a new term stays hidden until you use it.