# Listings categories management

{% hint style="info" %} <mark style="color:blue;">Path: SBO > Listings > Categories</mark>
{% endhint %}

* [Definition](#id-1.16.x-listingscategoriesmanagement-definition)
* [Create categories](#id-1.16.x-listingscategoriesmanagement-createcategories)
  * [How to create categories](#id-1.16.x-listingscategoriesmanagement-howtocreatecategories)
  * [How to create sub-categories](#id-1.16.x-listingscategoriesmanagement-howtocreatesub-categories)
* [Understand the categories display](#id-1.16.x-listingscategoriesmanagement-understandthecategoriesdisplay)
* [Update categories](#id-1.16.x-listingscategoriesmanagement-updatecategories)
  * [Edit a category](#id-1.16.x-listingscategoriesmanagement-editacategory)
  * [Manage categories hierarchy](#id-1.16.x-listingscategoriesmanagement-managecategorieshierarchy)
* [Delete a category](#id-1.16.x-listingscategoriesmanagement-deleteacategory)
* [Related resources](#id-1.16.x-listingscategoriesmanagement-relatedresources)

## Definition <a href="#id-1.16.x-listingscategoriesmanagement-definition" id="id-1.16.x-listingscategoriesmanagement-definition"></a>

A category groups together the listings/services according to their purposes.

**What is it used for?**&#x20;

* It is used to classify services into a category.&#x20;
* They can be classified in a hierarchy
* Categorizing services allows the platform users to easily find their way around the platform.&#x20;

Each category will have a dedicated search result page. Its content can be optimized via the fields related to that category in the SBO.

<mark style="color:orange;background-color:yellow;">WHO CAN USE THIS FEATURE?</mark>

It is up to the super-administrators/administrators to create the categories and subcategories, the offerers will just have to choose among them.

## Create categories <a href="#id-1.16.x-listingscategoriesmanagement-createcategories" id="id-1.16.x-listingscategoriesmanagement-createcategories"></a>

Super-administrators and administrators can create categories.

You can add a new category by clicking ‘*Add a category’ (figure 1).* It will open a modal that can be filled.

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/vuIw2hNxag1upL4ewD7R/image.png" alt=""><figcaption><p>Figure 1</p></figcaption></figure>

Let’s have a look at the information needed for a category (figure 2).

<figure><img src="https://2306631548-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4EIoqjZx1xWQIo6LnjB%2Fuploads%2FtbcZ2UUVErbqVzUAlmls%2Fimage.png?alt=media&#x26;token=5f34f06d-1b67-4ac9-ad62-a16a0ec1b3de" alt=""><figcaption></figcaption></figure>

{% hint style="success" %} <mark style="color:green;">The tooltip offers a description of each field.</mark>
{% endhint %}

* **The name**: This is the name given to a category that will be seen by every user of the platform.

{% hint style="warning" %} <mark style="color:orange;">Only the</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**name**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">and</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**types**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">are mandatory fields.</mark>
{% endhint %}

* **The slug:** The slug is a word that will be used in the URL.

{% hint style="info" %} <mark style="color:blue;">If it is not set, it will automatically be based on the category name.</mark>
{% endhint %}

* **The header Text:** This is a short description of the category. It will appear on the category page above listings (search result).
* **The footer Title**: This is the title before the footer text at the bottom of the category page (search result)
* **The footer Text**: This is the description of the category that will appear at the end of the category page (search result).
* **The meta-Title**: This is important for the platform’s SEO. The meta-title will be displayed on the tab of your web browser. It gives an idea of what category you are in, and it will be used in the Search Engines Results Pages (example: Google, Bing,…).
* **The meta-Description:** It goes hand in hand with the meta-title. Also important for the platform’s SEO. It is the description of the category content displayed by the page result of a web browser.
* **The parent Category:** It helps with the hierarchy of the categories. Select the parent category by clicking on the arrow, then a list of the existing categories will appear. It will then be possible to choose the place of a category on the category tree.
* **Types:** Specify the rendering type for the category. For example, if the admin selects a time-based rendering, only those listings can be included in the category's group

{% hint style="warning" %} <mark style="color:orange;">Types section are not requested when displaying RFP categories.</mark>
{% endhint %}

{% hint style="info" %} <mark style="color:blue;">When a child category is added under a parent category, it is mandatory for the child category to include at least one rendering type that has been selected in the parent category.</mark>
{% endhint %}

{% hint style="success" %} <mark style="color:green;">If a category doesn’t have a parent, only select ‘</mark>*<mark style="color:green;">Categories</mark>*<mark style="color:green;">’.</mark>
{% endhint %}

When the necessary fields are populated, click on *“Apply*” (figure 2) to save the new category, or click “*cancel*” (figure 2) to discard the modifications.

## Understand the categories display <a href="#id-1.16.x-listingscategoriesmanagement-understandthecategoriesdisplay" id="id-1.16.x-listingscategoriesmanagement-understandthecategoriesdisplay"></a>

All the categories of a platform are visible through the categories dashboard.

Categories can have hierarchies. There is a main category, called the parent category, that can contain sub-categories. Categories can be managed according to the needs of the platform.

Here are two examples :

One parent category with two sub-categories (figure 3).

* Category1 = Parent category
  * category 1\_1 = sub-category one
  * category 1\_2 = sub-category two

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/1p0z7wlPYHweyK6IZ2eh/image.png" alt=""><figcaption><p>Figure 3</p></figcaption></figure>

Another example can be (figure 4): One parent category has a sub-category that also has a sub-category.

* Category 2 = Parent category
  * Category 2\_1 = sub-category
    * Category 2\_1\_1 = sub-category of the sub-category
  * Category 2\_2

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/sX8NNPlRMWcWHzihBrmC/image.png" alt=""><figcaption><p>Figure 4</p></figcaption></figure>

For each category block, you can see:

* The name of the category
* The number of listing related to the category.\
  It may help understand which categories are the most used over the platform.

## Update categories <a href="#id-1.16.x-listingscategoriesmanagement-updatecategories" id="id-1.16.x-listingscategoriesmanagement-updatecategories"></a>

### Edit a category <a href="#id-1.16.x-listingscategoriesmanagement-editacategory" id="id-1.16.x-listingscategoriesmanagement-editacategory"></a>

To edit a category, click on the button “edit” in a category block (figure 5).

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/xX8FPwZz7WSepCq3tex4/image.png" alt=""><figcaption><p>Figure 5</p></figcaption></figure>

The fields are the same as “create a category” seen earlier in this article.

### Manage categories hierarchy <a href="#id-1.16.x-listingscategoriesmanagement-managecategorieshierarchy" id="id-1.16.x-listingscategoriesmanagement-managecategorieshierarchy"></a>

The categories' hierarchy is manageable. It is based on a drag-and-drop functionality (figure 6):

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/aUu22WhqFbkigRcTgZog/image.png" alt=""><figcaption><p>Figure 6</p></figcaption></figure>

1. Identify the category you want to change position in the category tree.
2. Using the drag-and-drop icon on the left side of the category block, click and hold the category while moving it to the desired position. It can be upwards, downwards, to the right, or left.

## Delete a category <a href="#id-1.16.x-listingscategoriesmanagement-deleteacategory" id="id-1.16.x-listingscategoriesmanagement-deleteacategory"></a>

A category can be deleted by clicking on the trash icon located on the right side of the category block (figure 7).

<figure><img src="https://content.gitbook.com/content/n4EIoqjZx1xWQIo6LnjB/blobs/T8YeS56qbcvxtHAFJMW0/image.png" alt=""><figcaption><p>Figure 7</p></figcaption></figure>

When clicking on it, a confirmation message will appear.

When a category is still used by at least one listing, the trach icon will have a light grey color.

{% hint style="warning" %} <mark style="color:orange;">You can not delete a category if there are listings associated.</mark>
{% endhint %}

{% hint style="success" %} <mark style="color:green;">Tips: Modify the categories about the related listings to be able to delete the category.</mark>
{% endhint %}

## Related resources <a href="#id-1.16.x-listingscategoriesmanagement-relatedresources" id="id-1.16.x-listingscategoriesmanagement-relatedresources"></a>

**SBO:**

* [Listings attribute management](https://features.scnd.com/v2.0/superadmin/listings/listings-attribute-management)

**Front:**

* [Listings search results page per category (All bundles)](https://features.scnd.com/v2.0/front-office/search-result-pages/listings-search-results-page-per-category-all-rendering-types)
