> For the complete documentation index, see [llms.txt](https://docs.stylemixthemes.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stylemixthemes.com/motors-theme-documentation/~/changes/70wBWN8w43jv4AA52cti/listing-management/inventory-listing-categories.md).

# Listing Categories

Listing categories are available in Dealership and Classified demo layouts. In the manual below you will find:

1. [Customization of Listing Categories](#customization-of-listing-categories).
2. [How to deal with taxonomies on the listing categories](#how-to-deal-with-taxonomies-on-the-listing-categories).
   1. [How to edit existing taxonomies](#how-to-edit-existing-taxonomies).
   2. [How to create a new taxonomy](#how-to-create-a-new-taxonomy).
3. [Relationship between listing categories](#relationship-between-listing-categories).

## Customization of Listing Categories

They are considered key features of the listings and include specific information about vehicles. The vehicles on the Inventory page are sorted by these categories on the Inventory Filter.

{% content-ref url="/pages/-MW-IMIXTMlDGbNDUkoW" %}
[Inventory Settings](/motors-theme-documentation/~/changes/70wBWN8w43jv4AA52cti/theme-options/inventory-settings.md)
{% endcontent-ref %}

You can modify the demo categories or add your own filter options via **WordPress Dashboard > Listings > Listing Categories** section.&#x20;

<figure><img src="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2F6UITiuq3woBWPGZNH6bt%2FMotors%205.17%20-%20Listing%20Categories%20Dashboard.png?alt=media&amp;token=562453f6-8634-4014-af62-f0537721f854" alt=""><figcaption></figcaption></figure>

The Category can be edited by expanding it or clicking on the pencil icon:

<figure><img src="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FTrXsBYkhJFVyVU61I3mD%2FMotors%205.17%20-%20Listing%20Categories%20edit.png?alt=media&amp;token=7c0da3b4-c8af-409c-bfc4-c61f46dfb2e4" alt=""><figcaption></figcaption></figure>

The available options for listing categories 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.
* **Choose icon** - The symbol representing the category will be shown on a single listing page:

<figure><img src="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FZV5XGDM3pEXeSIIZ0Wm8%2FMotors%205.17%20-%20Listing%20Categories%20icon.png?alt=media&amp;token=32066445-b1e9-442e-bbe8-9893937534a1" alt=""><figcaption></figcaption></figure>

* **Number field** - When a category is marked as "Number", it will only accept numerical values and not text. These filed can be displayed in Slider view on the Inventory page:

<figure><img src="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FbnJlyiohmTA2Jg09YRpL%2FMotors%205.17%20-%20Listing%20Categories%20number%20slider.png?alt=media&amp;token=f0dc39fa-2724-40b2-ad20-836411285f7d" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2Fjsj0vgND4H6nFM6HwKf1%2FMotors%205.17%20-%20Listing%20Categories%20grid.png?alt=media&amp;token=02e7ef78-a76b-46fb-9c81-a70f84ab2100" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FAMsUBm8x4s1Ki3SkrZZZ%2FMotors%205.17%20-%20Listing%20Categories%20list.png?alt=media&amp;token=91e18652-dccd-4f0c-b76c-1e4a89b5953e" alt=""><figcaption></figcaption></figure>

* **Use on the single car 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/>" %}

* **Use on a car filter** - the category will be included in Classic Inventory:

<figure><img src="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FTeFXF8seVy6ruUHLDCap%2FMotors%205.17%20-%20Listing%20Categories%20in%20classic%20filter.png?alt=media&amp;token=53cd8772-9e99-4902-943a-3edacf21e7f9" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FPzrZDbukB2sLKuIqe6dF%2FMotors%205.17%20-%20Listing%20Categories%20in%20tabs.png?alt=media&amp;token=9af8102f-25d6-458e-86b4-cac4171ebd31" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2Fz77qTLkb7t3RQkzRehj4%2FMotors%205.17%20-%20Listing%20Categories%20in%20modern%20filter.png?alt=media&amp;token=07bcad6d-4cdd-4047-9dff-f32b82d2242a" alt=""><figcaption></figcaption></figure>

* **Use images for this category** - when activated, it becomes possible to upload images for the taxonomies associated with this category:

<figure><img src="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2F71IKif02AvVq9m1mZBSj%2FMotors%205.17%20-%20Listing%20Categories%20imaghe%20enabled.png?alt=media&amp;token=d5e93e65-e045-4fe0-bb40-1a3ae863e84e" alt=""><figcaption></figcaption></figure>

* **Use on car filter as a block with links** - when enabled the options of the category will be displayed in the list view on the Classic filter:

<figure><img src="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FVpDzXLlapB6Q8L8HURTJ%2FMotors%205.17%20-%20Listing%20Categories%20in%20links.png?alt=media&amp;token=48d33d9a-1ab2-49d9-88ad-59de92be68aa" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FdaZspCqaxqZUOGuowKvZ%2FMotors%205.17%20-%20Listing%20Categories%20in%20footer.png?alt=media&amp;token=5302180b-060e-4be8-a162-7ab59417c43e" alt=""><figcaption></figcaption></figure>

* **Use this category in generated Listing 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="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FCTxpXSXpzfIl43p1M89i%2FMotors%205.17%20-%20Listing%20Categories%20in%20generated%20title.png?alt=media&amp;token=4942c614-715f-44be-803f-773145028ee3" alt=""><figcaption></figcaption></figure>

* **Set parent taxonomy** - it is possible to set a certain listing category as a parent for another one. In this case, there will be a [relationship between the taxonomies of these categories](#relationship-between-listing-categories).
* **Use on the listing archive as checkboxes** - the taxonomies will be displayed in the checkbox view in the Inventory filter:

<figure><img src="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FlAenQwmR5BUdx4p3uqNI%2FMotors%205.17%20-%20Listing%20Categories%20checkbox.png?alt=media&amp;token=f35dd2b7-2f4e-4fb8-b575-e9753d3ef85f" alt=""><figcaption></figcaption></figure>

* **Show in the admin column table** - the options will be displayed for site administrator in Dashboard > Listings > All items section:

<figure><img src="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FAvHEshHXRSgpUjLZXZXN%2FMotors%205.17%20-%20Listing%20Categories%20in%20admin.png?alt=media&amp;token=faf31a49-a90a-4955-8c5c-3b122d3cdc8d" alt=""><figcaption></figcaption></figure>

***

## How to deal with taxonomies on the listing categories

To make changes to the default taxonomies/values of the listing category, simply click on the list icon in the manage column:

<figure><img src="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FEk0XRHLXoIPvx1v50E0A%2FMotors%205.17%20-%20Listing%20Categories%20manage.png?alt=media&amp;token=a21899ee-3756-44ca-ac6a-53b1be3425f5" alt=""><figcaption></figcaption></figure>

### How to edit existing taxonomies

Taxonomies that already exist can be modified or removed in an opened window:

<figure><img src="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FvedsELXwpjf84dR5RBch%2FMotors%205.17%20-%20Listing%20Categories%20taxonomy%20edit.png?alt=media&amp;token=4621025d-41f2-48d9-bcd9-38d2a88873b4" alt=""><figcaption></figcaption></figure>

### How to create a new taxonomy

To add a new classification for a chosen category of listings, just complete the necessary information and click on the save button:

<figure><img src="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FmrjstCK0G4vjyYi7OV5A%2FMotors%205.17%20-%20Listing%20Categories%20new.png?alt=media&amp;token=4e418332-9fb0-4dc1-a329-9a80c443993e" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Adding additional taxonomies can be beneficial for modifying the minimum and maximum values of numerical fields like Price.
{% endhint %}

<figure><img src="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FJzf5y9chYcBNO0BQDRKY%2FMotors%205.17%20-%20Listing%20Categories%20price%20min%20and%20max.png?alt=media&amp;token=dea259f5-a70b-46d9-9ec7-4641558f5206" alt=""><figcaption></figcaption></figure>

***

## Relationship between listing categories

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:**

By editing the "Model" listing category we will set the "Make" category as a parent:

<figure><img src="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FVMpJWQVpP6IQ7qETUj43%2FMotors%205.17%20-%20Listing%20Categories%20set%20parent.png?alt=media&amp;token=bfcab516-f7ce-4d66-a14b-c7add3257c31" alt=""><figcaption></figcaption></figure>

After this it is required to go to Manage Models and set the correct parent Makes for each Model:

![](https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FPvrLVudTUPCA08EA3Cy7%2FMotors%205.17%20-%20Listing%20Categories%20parent%20set.png?alt=media\&token=750ef1d2-92b4-4142-8f24-17fd558e60b2)

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

<figure><img src="https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2F4xF2SmQdY948iZ6jN3AV%2FMotors%205.17%20-%20Listing%20Categories%20in%20search%20filter.png?alt=media&amp;token=2eafdf6e-4e8d-4235-8bb1-e2b97f349c08" alt=""><figcaption></figcaption></figure>

{% 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/~/changes/70wBWN8w43jv4AA52cti/listing-management/import-makes-and-models.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.stylemixthemes.com/motors-theme-documentation/~/changes/70wBWN8w43jv4AA52cti/listing-management/inventory-listing-categories.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
