Skip to content

Custom fields overview and adding a new field on single / inventory page

Custom fields are how a Listivo listing stores everything beyond its title and description. This guide walks through all ten field types, the settings they share, and how to place a new field on your search results page and single ad page.

5 minute read

We have created a transparent system for adding custom fields that you can quickly adapt to your needs. Below you can find descriptions and detailed information about each type of field.

In this article you will find

  • Types of custom fields
  • Common settings for custom fields
  • Inventory page

Types of Custom Fields

  1. Taxonomy
  2. Text
  3. Rich Text
  4. Number
  5. Price
  6. Location
  7. Embed
  8. Gallery
  9. Attachments
  10. Salary

1. Taxonomy

In Listivo, you can use a taxonomy to organize groups of your listings. For example, in one of the Listivo demos you can see how a taxonomy was used for the category field.

The WordPress Category taxonomy screen opened from the Listivo panel, with the Add New Category form on the left and existing terms such as Community, Announcements, Free Stuff, Lost & Found and Devices listed on the right.

You can use as many taxonomy-type fields as you need on your website. For example, we used this type for the following fields in our demo.

The Listivo custom fields list with the Type column highlighted: Category, Contract Type, Recruiter Type, Job Level, Model, Make, Hours, Vehicle Features, Property Features and Service Type are all of type Taxonomy.

2. Text

Text is intended for a simple, small field. You can use it for a VIN or your internal listing number.

3. Rich Text

You can use it to add additional text beyond the description to the listing — for example, other services or special offers.

4. Number

The Number field can be used for the year of construction, the size of a property or the mileage of a car. Depending on your needs, the field can also be configured to display a value after or before the number entered. You can put masks on the field. The values given in it will not appear in the loan calculator.

The custom fields list showing Bathrooms, Bedrooms, Property Size, Build Year and Year with the type Number, below Category and Contract Type of type Taxonomy.

5. Price

The field is used to provide the price of the added listing. Depending on your needs, the field can be configured to display a value after or before the price entered. The values given in it will appear in the loan calculator.

The Edit Field form for the Price field, with the Text After Value box containing /month highlighted.

6. Location

Our product is integrated with Google Maps. After adding your API key, you can add a location to each listing.

The Maps tab of Listivo Panel Settings, with arrows pointing to Settings in the sidebar, the Maps tab, and the empty Google Maps API Key box under Map Provider set to Google Maps.

You can adjust the settings depending on your preferences. You can choose the Map Type (roadmap, satellite, hybrid, terrain), the Search Type (cities, regions, address) and the Input Type (geocode, establishment, cities, regions, address). You can also set the countries you want to restrict the location to on your website (max 5).

The Edit Field form for a Location field, showing Map Type set to Roadmap, Search Type and Input Type both set to (cities), and Country Restrictions (Max 5) set to No Restrictions.

7. Embed

You can use this type of field more than once. It can be a link to a video (e.g. from YouTube), or for more advanced users you can allow raw HTML.

The custom fields list with the Video and Virtual Tour rows highlighted, both of type Embed, between the Category and Contract Type taxonomy rows.

8. Gallery

Thanks to this field type, you can add photos to your listing. If necessary, more than one gallery can be added to one listing. You can configure it and add restrictions on the size of photos and the number of photos.

The Edit Field form for a Gallery field, with Max Image Number set to 20 and Max File Size (MB) set to 8 highlighted.

9. Attachments

The field type is used to add the necessary attachments to the listing. It can be a technical specification, a leaflet, or a sample contract. The configuration allows you to limit the size and number of attachments.

The Edit Field form for an Attachments field, with Max Image Number set to 10 and Max File Size (MB) set to 8 highlighted.

10. Salary

The field is used to specify the salary of an added listing, e.g. for a job advertisement. Depending on your needs, the field can be configured to display a value after or before the amount entered (for example, text after the value such as / month). The values given in it will not appear in the loan calculator.

The Edit Field form for a Salary field, with an empty Text Before Value box and a Text After Value box containing /month both highlighted.

Common settings for Custom Fields

Some background information about the settings every field type shares.

All fields have the possibility to check 'is Required' — thanks to this, you cannot add a listing without this field.

The Edit Field form for the Category field with the ticked Required checkbox highlighted.

A 'Slug' is automatically added to each field. You can change it if you want. A slug is the part of the URL that explains the page's content.

The Edit Field form for the Category field with the Slug box, containing 'category', highlighted.

'Multilevel' is an option that allows you to select more than one category for the listing.

The Edit Field form for the Category field with the ticked Multilevel checkbox highlighted, labelled 'Allows you to create a multi-level hierarchy of terms.'

The Input Placeholder field gives a short hint that describes the expected value of an input field. The hint is displayed before the user enters a value. For example, use it to tell the user what information should go in the field.

The Edit Field form for the Price field with the Input Placeholder box, containing 'Enter the price', highlighted.

'Who can see this field on the single listing page?' and 'Who can fill out this field on the frontend panel?' allow you to control visibility depending on the type of user.

The two visibility settings with the role list open, offering Everyone, Administrator, Editor, Author, Contributor, Subscriber and Listivo User.

You can also hide chosen fields depending on the categories. In 'Hide Terms', you simply select the categories. For example, the salary field is not used in apartments, boats, or cars.

The Hide Terms setting row in the field settings: the label Hide Terms on the left and, in a box to its right, the selected term chips Community, Jobs and Services.

Inventory page

A new field is not displayed automatically
The newly added field will not show automatically on your Search Form or Single Vehicle Page. You need to add it to each template manually, as shown below.

Add the field to the search results page

  1. 1 Open the template

    Go to Listivo Panel -> Templates and pick the template you want to edit. In the example below, we edit the search results page.

    The Listivo Panel Templates screen with the Search Results Page tab open and the Edit button next to the Sidebar Search template highlighted.
  2. 2 Open the Search V2 widget

    Using Elementor, you can add your new field to the Search V2 widget.

    Elementor with the Search V2 widget open, its Sidebar fields list of numbered items on the left and a live preview of the search results page with category and price filters on the right.
  3. 3 Add an item

    Click on the "Add item" button under the list of fields.

    The Elementor field list with a green arrow pointing at the ADD ITEM button below Item #7.
  4. 4 Pick your field

    Select the new field from the list. Configure how you would like to display it, and remember to update.

    The new item's Field dropdown open, listing Keyword, Category, Price, Bedrooms, Bathrooms, Build Year, Property Size, Salary, Make, Model, Year and Mileage among others, with arrows pointing to ADD ITEM and the green UPDATE button.

Add the field to the single ad page

  1. 1 Open the template

    Go to Listivo Panel -> Templates and pick the template you want to edit. In the example below, we edit the Single Page.

    The Listivo Panel Templates screen with the Ad Page tab open, listing the Carousel, Mosaic and Gallery templates, and the Edit button next to Gallery highlighted.
  2. 2 Add the field to the widget

    Using Elementor, you can add your new field to the widget.

    Elementor editing the Ad attributes V3 widget, with Item #2 set to the Bedrooms field and Display Label switched on, and the ad preview on the right showing a 'Bedrooms: 3' chip under the title Modern apartment.
  3. 3 Pick your field

    Select the new field from the list. Configure how you would like to display it, and remember to update.

Ask the people who build Listivo

We answer by email from support@tangiblewp.com. With Premium Support, we also fix your site when something breaks.

Was this guide helpful?