Custom fields

We get that every agency is different so we've made Property Hive as flexible as possible by allowing you to customise the values that appear in certain fields such as 'Property Type', 'Location' and much more.

These custom fields are widespread across Property Hive, including property details, search forms, applicant requirements and email alerts, portal feeds and much more.

As a result, we recommend that one of the first things you do when you've installed Property Hive is to ensure these are configured to match your agency.

To access and customise the custom fields navigate to 'Property Hive > Settings > Custom Fields':

If you don't see the 'Settings' submenu option available it could mean your user role doesn't have the right permissions as this is only available to administrators.

Here you'll see a list of all the custom fields that are available to edit.

The custom fields that show here might differ depending on a number of circumstances, including which departments you have active.

When you install Property Hive for the first time we'll pre-fill all of the custom fields with some default values to get you started.

The only custom field we don't add any default values to is 'Location' as this really is agency specific based on where you're based.

Editing a custom field

When you select one of the custom fields you'll be presented with a list of the options that exist within that custom field. For example, if you click into 'Availabilities' (also known as 'status') you'll see the following list:

All custom fields follow a similar format. There are a few that are slightly different but we'll come to that in a bit.

You'll have a list of all the availabilities including the term ID (useful if doing bespoke work or using shortcodes and wanting to only show properties with a certain availability), the value and the number of properties assigned to that term.

The number of 'Assigned Properties' that shows is all properties regardless of 'on market' status.

Adding/Editing a custom field value

To add a new custom field value click 'Add New {custom field name}':

To edit an existing value, simply click 'Edit':

On the next screen you'll have the option to specify the custom field value name and, in some scenarios a few extra fields.

Availabilities - You'll have the ability to specify which departments an availability is relevant to:

Property Types and Locations - These custom fields are hierarchical meaning they have a parent-child relationship. When editing these you'll have the option to set a parent:

Click 'Save changes' to save any amendments made.

Deleting custom field values

You can delete a custom field value by either clicking delete next to the value in question:

Or you can bulk delete values in mass by selecting which values you wish to delete and clicking 'Delete Selected':

Either way you'll get taken to a screen where, if these values were assigned to any properties or applicants, you'll be given the ability to re-assign them accordingly:

Advanced: A word on how these are stored

All custom fields in Property Hive are essentially taxonomies in WordPress with each value being a term.

As such, should you be writing a custom snippet or similar that needs to filter on one of these custom fields you'd use tax_query and not a meta_query .