Custom fields

Custom fields let you record information the standard property form does not cover: energy rating, year of construction, service charge, parking spaces. You define the fields once, and they appear on every property form afterwards.

Open the page with the Field Management button on the property list. It is headed "Field Management — Create and organize categories and custom fields for your properties".

Note
This page is for administrators only. An agent who opens it sees "Access denied" and "Field Management is available to administrators only.", with a Back to Properties button.

How it is organised

Fields belong to categories. A category is a titled block in the property form; the fields inside it appear together. Fields with no category are grouped at the end under "Uncategorized".

The page lists every category as a card, with its fields in a table underneath.

Field	Required	Accepts	Purpose
Name	Yes	Text. Placeholder: "E.g. Technical features"	Heading shown above the group in the property form
Slug	Yes	Lowercase letters, digits and dashes. Filled in automatically from the name	Internal identifier
Description	No	Text	Shown under the heading in the property form
Icon (optional)	No	An icon name	Icon shown next to the heading. Click an icon to select it, click again to clear it
Active category	No	Checkbox, on by default	Whether the category is in use

Fields

Each category card holds a table with one row per field.

Column	Shows
Label	The name the user sees in the form. Inactive fields are marked "inactive"
Identifier	The internal key
Type	The field type
Req.	A red dot when the field is required
Admin	An open eye when the field is visible in the back office
Public	An open eye when the field is visible on the public website
Actions	Edit and delete

Inactive fields are shown faded.

Creating a field

Click New field at the top of the page, or Add field on a category card to start with that category preselected.

Field	Required	Accepts	Purpose
Label	Yes	Text. Placeholder: "E.g. Year of construction"	What the user sees
Identifier (field_name)	Yes	Lowercase letters, digits and underscores. Filled in from the label	Internal key. Cannot be changed after creation
Description (internal)	No	Text	Internal notes — not shown to clients
Type	Yes	See the table below	Decides which input is shown. Cannot be changed after creation
Category	No	One of your categories, or "— No category —"	Where the field appears
Options	Only for Dropdown and Multi-select	One option per line	The choices offered
Display as checkbox group	Only for Multi-select	Checkbox	Shows the options as checkboxes instead of a multi-selection list
Placeholder	No	Text	Hint shown inside the empty field
Help text	No	Text	Explanation shown below the field
Sort order	No	A number	Position within the category. Lower numbers come first

Field types

Type as shown	What the user gets
Short text (TEXT)	A single-line text box
Long text (TEXTAREA)	A multi-line text box
Integer (NUMBER)	A whole number
Decimal number	A number with decimals
Boolean (BOOLEAN)	A single checkbox reading Yes or No
Dropdown (SELECT)	A list where one option can be chosen
Multi-select / CHECKBOX	A list where several options can be chosen
Date (DATE)	A date picker
Date & time	A date and time picker
Email	A text box validated as an email address
URL	A text box validated as a web address
Phone	A text box for a telephone number
Currency	A number with two decimal places
Image	A box for an image address

Visibility and behaviour

Six switches control what happens to the field.

Switch	Effect
Required	The property cannot be saved without a value
Active	Turn off to retire the field without deleting it
Visible in admin area	The field appears on the property form in the back office
Visible on public site	The field appears on the property page of your website
Available as filter	The field can be used to filter listings
Searchable	The field's content is included in website search

These three depend on each other, and the form enforces it:

Turning on Visible on public site forces Visible in admin area on and locks it. The form explains: "When visible on the public site, the field is also automatically visible in admin."

Turning on Searchable forces Visible on public site on and locks it: "A searchable field must also be visible on the public site — the "public" flag is therefore forced on and cannot be disabled."

Editing a field

Click the pencil icon. Everything can be changed except the Identifier and the Type, which are locked with the note "Type cannot be changed after creation."

Deleting a field

Click the bin icon. The confirmation reads:

Delete field "<label>"?
Values already saved on properties will remain in the database but will no longer be visible.

Note
Deleting a field hides its data rather than erasing it. Restoring visibility means recreating a field with the same identifier — which is only possible if nothing else has taken that identifier in the meantime.

Where the fields appear

On the property form, custom fields appear below Furnishing & Target Audience, grouped by category, two per row (long text fields take the full width). Only fields marked Visible in admin area and Active are shown.

If no fields exist, the property form shows a single card reading "Custom fields — No custom fields configured." with a Configure custom fields link.

Messages

Message	When
Category created / updated / deleted	The action succeeded
Field created / updated / deleted	The action succeeded
Could not create the category	The category was refused
Could not update the category	The change was refused
Could not delete the category	The deletion was refused
Could not create the field	The field was refused
Could not update the field	The change was refused
Could not delete the field	The deletion was refused

Validation on the property form

When a value does not fit its field, the message names the field. Examples: "Year of construction is required", "Year of construction must be at least 1900", "Service charge can have at most 2 decimal places", "Contact email must be a valid email address", "Website must be a valid URL", "Facilities contains invalid options: pool".

Empty state

With nothing configured yet, the page reads "Start creating your custom fields" and "Categories group fields in the property form. Start by creating a category, then add the fields you want to manage.", with New category and New field buttons.

Custom fields

How it is organised

Categories

Creating a category

Editing and deleting a category

Fields

Creating a field

Field types

Visibility and behaviour

Editing a field

Deleting a field

Where the fields appear

Messages

Validation on the property form

Empty state

Custom fields

How it is organised#

Categories#

Creating a category#

Editing and deleting a category#

Fields#

Creating a field#

Field types#

Visibility and behaviour#

Editing a field#

Deleting a field#

Where the fields appear#

Messages#

Validation on the property form#

Empty state#

How it is organised

Categories

Creating a category

Editing and deleting a category

Fields

Creating a field

Field types

Visibility and behaviour

Editing a field

Deleting a field

Where the fields appear

Messages

Validation on the property form

Empty state