# Custom Fields

**Custom Fields** also known as **Listing categories** tab is available in Dealership and Classified demo layouts. In the manual below you will find:

1. [**Customization of Custom Fields**](#customization-of-custom-fields)
   1. [**Custom Field Details**](#custom-field-details)
2. [**Relationship between custom fields**](#relationship-between-custom-fields)
   1. [**Example of Setting Parent Category** ](#set-parent-category-make-for-models)

{% hint style="info" %}
Settings in the **Custom Fields** tab **may vary** based on the imported demo.
{% endhint %}

If you want to learn about Custom Field Options, refer to this manual:

{% content-ref url="/pages/wudXHLCT2xqJWSNUHlIj" %}
[Custom Field Options](/motors-theme-documentation/search-filter/inventory-listing-categories/custom-field-options.md)
{% endcontent-ref %}

## Customization of Custom Fields

Custom Fields or Listing Categories are considered key listing features and include specific vehicle information. The vehicles on the Search Results page are sorted by these categories on the Inventory Filter.

{% content-ref url="/pages/FlUUG9VTidYpvjnunieI" %}
[Search Results Page](/motors-theme-documentation/search-filter/search-results-page.md)
{% endcontent-ref %}

The **WordPress Dashboard > Motors Plugin > Custom Fields** section allows you to modify the demo categories or add your own filter options. 

<figure><img src="/files/BEWsXlhDnXEfq7MdbNUI" alt=""><figcaption></figcaption></figure>

The Category (custom field) can be edited by simply clicking on it:

<figure><img src="/files/rXo7GsB08Ldo9sr4qWtd" alt=""><figcaption></figcaption></figure>

### Custom Field Details

When creating custom fields (listing categories) in the Motors plugin, several fields are essential for properly setting up and displaying your categories. Custom Field Details are organized into three sections:

* [**General**](#general)
* [**Display Settings**](#display-settings)
* [**Filter Settings**](#filter-settings)

<figure><img src="/files/Kco6gEVaGvPH9rjIpYpA" alt=""><figcaption><p>Overview of the Custom Field Details sections</p></figcaption></figure>

#### General

<figure><img src="/files/QvOpbKDh72ggRvdXgd2C" alt=""><figcaption><p>Overview of the General section of the Custom Field Details</p></figcaption></figure>

The available options for listing categories (custom fields) are as follows:

* **Singular name** - Singular label of Listing category.
* **Plural name** - Plural label of Listing category.
* **Slug** - The URL for the listing category should be as short as possible.
* **Select a Parent Field** – allows you to [**nest this field**](#relationship-between-custom-fields) under an existing field (its “parent”). If you do not want this field to be nested, choose “No parent.”&#x20;
* **Choose icon** - The symbol representing the category will be shown on a single listing page:

<figure><img src="/files/SrQ2lvlaTbHAuihB4n70" alt=""><figcaption></figcaption></figure>

* **Required** – when adding a new listing, all the fields marked as required must be filled in.
* **Field Type** – specifies the format of the data for your custom field (for example, a dropdown list or a numerical value).
  * **Dropdown Select** – when you select this type, the field will display a list of options from which users can choose.
  * **Number field** – when a custom field is marked as “Number,” it only accepts numerical values, not text. These fields can be displayed in Slider view on the [**Search Results Page**](/motors-theme-documentation/search-filter/search-results-page.md) (Inventory page).
    * **Field unit** – lets you specify a unit or suffix (for example, “kg,” “$,” “cm”) that appears alongside the numerical value. It will be displayed on all pages.
    * **Add Separator** – toggles whether a separator will appear between the numerical value and the field unit.
    * **Field display options in tabs** – allows you to choose how the field appears on a listing’s detail tabs (e.g., “Dropdown with Range” or “Slider Range”). If Slider Ranges is selected, you can adjust the step size as well.
    * **Field display options in filters** – lets you set how the field can be filtered on listing pages (e.g., “Dropdown with Range” or “Slider Range”). If Slider Ranges is selected, you can adjust the step size as well.

<figure><img src="/files/zNbTuliRs9wgigRmj6Kk" alt=""><figcaption></figcaption></figure>

#### Display Settings

<figure><img src="/files/4qXozelwmIginVGVby6y" alt=""><figcaption><p>Overview of the Display Settings section of the Custom Field Details</p></figcaption></figure>

* **Show on grid view** - when the option is enabled the category will be visible in Grid view on the inventory page:

<figure><img src="/files/KU5ms9yWhD9sIZc9VZhx" alt=""><figcaption><p><strong>Show on grid view</strong></p></figcaption></figure>

* **Show on list view** - when the option is enabled the category will be visible in the List view on the inventory page:

<figure><img src="/files/XXkxXn4u8qXttjkxMLUl" alt=""><figcaption><p><strong>Show on list view</strong></p></figcaption></figure>

* **Show on listing page** - the category with its value will be included in the "Car Details section":

{% embed url="<https://motors.stylemixthemes.com/elementor-classified-one/listings/lamborghini-huracan/>" %}

<figure><img src="/files/rMreTNvYI9ZGJGCzXDO0" alt=""><figcaption><p><strong>Show on listing page</strong></p></figcaption></figure>

* **Show in Admin Column Table** - the options will be displayed for site administrator in **Dashboard > Listings > All items** section:

<figure><img src="/files/ge5vhrt3cUonOAV18ykq" alt=""><figcaption></figcaption></figure>

#### Filter Settings

<figure><img src="/files/XdL7hV9uSca13pvJTCyz" alt=""><figcaption><p>Overview of the Filter Setting section of Custom Field Details</p></figcaption></figure>

* **Sort Custom Field Options** - choose one of the sorting options to sort the [**custom field options**](#modifying-taxonomies-on-the-custom-fields)**:**&#x20;
  * **Count Low to High**
  * **Count High to Low**
  * **Name A to Z**
  * **Name Z to A**
* **Multiple Filter Select** – allows users to select more than one option at a time in the filter. If disabled, only one selection can be made.
* **Show in Filters** - the category will be included in Classic Inventory:

<figure><img src="/files/QBq7R0h407TTTOtU1JbA" alt=""><figcaption></figcaption></figure>

* **Show as a Block with Links** – displays the [**custom field options**](#manage-options-taxonomies-on-the-custom-fields) in the filter in a block format with clickable links. This can make it easier for users to navigate or select options at a glance.
  * **Layout Options** – lets you control how the filter section is displayed (e.g., “Show box open by default” or “Show box closed by default”).&#x20;

<figure><img src="/files/dvwSpcoreggCHW50HTlc" alt=""><figcaption><p><strong>Show as a Block with Links</strong></p></figcaption></figure>

* **Show in tabs** - The category will be displayed in tabs of the inventory page in the Motorcycles demo:

<figure><img src="/files/UhWcYWnj5M4CqnJEEaFv" alt=""><figcaption></figcaption></figure>

* **Show in modern filter** -  the category will be included in Modern Inventory in WPBakery Page builder:

<figure><img src="/files/QhYRmkLF0TKW6pVfjHoc" alt=""><figcaption></figcaption></figure>

* **Show in footer search** - when enabled, the taxonomies can be searched in the footer search of Classified demos:

<figure><img src="/files/WKkiJ1AwS0aqRr96rv2W" alt=""><figcaption></figcaption></figure>

* **Show in Listing Info Page** – toggles whether the chosen filter value for this field is displayed on the [**Listing Info Page**](/motors-theme-documentation/listing-management/inventory-single-listing.md).
* **Show as Checkboxes in the Inventory Filter** – switches the filter display style to checkboxes when viewing listings in the Search Results Page (Inventory) Filter area, so users can easily pick multiple options.
  * **Layout Options -** choose one of the 1 or 2 columns per row options&#x20;
  * **Item Display Options** – allows you to set how items within this filter are revealed to the user (e.g., “Show box open by default” or “Show box closed by default”) for a more tailored user experience.
  * **Add Submit Button to This Checkbox Area** – adds a submit button directly alongside the checkboxes, letting users confirm their selections without scrolling or navigating away.

<figure><img src="/files/OcB8r3x08JL2DeelHdOA" alt=""><figcaption><p><strong>Show as Checkboxes in the Inventory Filter</strong> </p></figcaption></figure>

* **Show in Generated Filter Title** - the chosen options will be included in the title of the search results for the inventory in **WPBakery Classified** demos:

<figure><img src="/files/yeib2ehP9oh0wKtcXOMC" alt=""><figcaption></figcaption></figure>

* **Use on the listing archive as checkboxes** - the taxonomies will be displayed in the checkbox view in the Inventory filter:

<figure><img src="/files/d26ojKkmUZVaomd2Xx8R" alt=""><figcaption></figcaption></figure>

***

## Relationship Between Custom Fields

The relationship feature is included for the Listing Search widgets that appear on the home page and Inventory filters. The feature allows connecting taxonomies and displaying child taxonomies depending on parent one.&#x20;

This option helps to find & select needed makes and models faster. In order to realize this relationship you need to follow these steps:

### **Set Parent Category (Make) for Models:**

{% stepper %}
{% step %}
By editing the "Model" listing category we will set the "Make" category (custom field) as a parent:

<figure><img src="/files/2SRCkGPaNwvHt62cWBM0" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
After this, it is required to go to **Manage Options:**

<figure><img src="/files/dDpcCLnNddf8fpWEu5Xq" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Set the correct parent **Makes** for each **Model**:

![](/files/qwqNuOzX1bDQH0rOhaZ3)
{% endstep %}

{% step %}
Now, when you select make from the Search form only corresponding models will be displayed:

<figure><img src="/files/E4Nl03Bi67dRXGQa1q3B" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="success" %}
The parent-child relationship between Makes and Models can be imported in bulk using the manual provided below.
{% endhint %}

{% content-ref url="/pages/0GygJpMqw6V7JdE9y2K4" %}
[Import Makes & Models](/motors-theme-documentation/listing-management/import-makes-and-models.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stylemixthemes.com/motors-theme-documentation/search-filter/inventory-listing-categories.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.