How to add listing attributes

If you want to add custom listing fields (in HivePress, they are called "attributes"), you can do that in the WP Dashboard > Listings > Attributes > Add New section. Each attribute can be customized in several different contexts: Editing, Search, and Display.

You can also make attributes category-specific. In the right sidebar, you can assign an attribute to specific listing categories. If you leave all categories unselected, the attribute will be available for all categories.

We’ll cover each context and its settings below.

Editing

Editable - if this is enabled, users will be able to edit this field on the front end;
Moderation - if this is enabled, website admins will have to manually approve any changes to this attribute (e.g., if a user changes some value, the admin approval will be required);
Field Type - here, you can choose the attribute type like URL, Text, Checkbox, etc.;
Description - you can add the attribute description if it's unclear (it will appear below the attribute title);
Placeholder - here, you can set the text that will be displayed in the attribute field as a hint until you enter the actual value.

Search

Filterable - enable it if you want to allow users to use this attribute value as a search filter for listings;
Indexable - enable it if you want to allow users to find this attribute value via keyword search;
Searchable - enable this option if you want to allow users to use this attribute value as an option to search for listings in the search bar;
Sortable - allows users to sort listings using the attribute value;
Field Type - here, you can specify how the filter will be displayed in the sidebar.

Display

Areas - here, you can define where the attribute will appear on the listing template (please check the picture below to get a better idea of the template areas);
Icon - here, you can set an icon for your attribute;
Format - here, you can set how the attribute will look on the front end using existing tokens or additional HTML code (e.g., you can set it as a link <a href="%value%">Custom link</a> )

The screencast below shows the process of adding listing attributes.

Now, when adding a new listing or editing the existing one, there should be a new custom field in the listing submission form.