# Service Catalog

### Introduction

The Service Catalog in GLPI 11.0 represents a major redesign of the self-service interface, providing end users with a modern and intuitive experience to access IT services. This new version introduces an advanced categorization system, visual illustrations, and intelligent search capabilities.

#### Service Catalog Objectives

* **Simplify service access**: Modern and intuitive interface;
* **Enhance user experience**: Category-based navigation with illustrations;
* **Facilitate search**: Advanced fuzzy search and smart filters;
* **Organize services**: Hierarchical category system;
* **Customize display**: Rich illustrations and descriptions;

### Service Catalog Configuration

#### Enabling the Service Catalog

**Step 1: Global Configuration**

1. Log in with an administrator account;
2. Navigate to **`Administration` > `Entities`**;
3. Select the root entity or target entity;
4. Access the **Helpdesk home** tab;

![Entity configuration page, Helpdesk home tab](https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FVNEtCHDH94XCKQ6b8deW%2Fsetup_heldesk_home.png?alt=media\&token=09822e36-4009-461c-9d7b-a6446eb131fa)

**Step 2: Catalog Settings**

The configuration options available are:

**Search bar**:

* **Options**: Enabled/Disabled;
* **For child entities**: additional "**Inherited from parent entity**" option;

**Service catalog**:

* **Options**: Enabled/Disabled
* **For child entities**: additional "**Inherited from parent entity**" option

**Expand categories in the service catalog**:

* **Options**: Enabled/Disabled
* **For child entities**: additional "**Inherited from parent entity**" option

<figure><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FzKQmGLcxUJ6BjtEkdsvY%2Fgeneral_setup_heldpdesk_home.png?alt=media&#x26;token=fdf91887-c86b-45f8-9053-ad0211908fdb" alt=""><figcaption><p>Service catalog configuration options (Bottom of <strong><code>Administration</code></strong> > <strong><code>Entities</code></strong> > Helpdesk home Tab)</p></figcaption></figure>

**Step 3: Save Configuration**

Click the **"Save general settings"** button to apply the changes.

***

### Categories Management

#### Creating Categories

**Step 1: Access to Category Management**

1. Navigate to **`Administration` > `Forms` > `Service catalog categories`**&#x20;

   <div align="left"><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FncBNlV4uTRvMkMx52hvv%2Fview_category_service_catalog.png?alt=media&#x26;token=b69cffdf-5f8f-46e5-8b7e-a1262aab6d52" alt="Service catalog categories button"></div>

2. Click **Add** to create a new category

   ![Form categories list](https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2F4GswcSqBKIMJo8L9LNzu%2Fadd_category_service_catalog.png?alt=media\&token=798c8ed6-e91d-408a-a703-f3c1750d4b99)

**Step 2: Category Configuration**

| Field            | Description                   | Required |
| ---------------- | ----------------------------- | -------- |
| **Name**         | Name displayed in the catalog | ✅ Yes    |
| **Description**  | Rich description (HTML)       | ❌ No     |
| **Illustration** | Representative image          | ❌ No     |
| **Category**     | Parent hierarchy (optional)   | ❌ No     |

![Category creation form](https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FjJ8CHmPNPb3txjC7IFlT%2Fgeneral_view_category.png?alt=media\&token=82fa9447-337b-4fb7-95f4-e3c83553c905)

**Step 3: Visual Settings**

**Illustration**:

* Supported formats: PNG, JPG;
* Recommended size: 400x300px;
* Default illustration if not specified;

**Rich description**:

* Limited HTML support (no images)

#### Hierarchical Organization

**Recommended structure**:

```
📁 IT Services
├── 📁 Hardware
│   ├── 📋 Computer request
│   └── 📋 Accessory request
├── 📁 Software
│   ├── 📋 Software installation
│   └── 📋 Software license
└── 📁 Support
    ├── 📋 Technical assistance
    └── 📋 Training
```

**Best practices**:

* Maximum 3 levels depth
* Short and explicit names
* Consistent illustrations by theme
* Clear and concise descriptions

***

### Forms Configuration

#### Adding a Form to the Catalog

**Step 1: Form Creation/Edition**

1. Navigate to **`Administration` > `Forms`**
2. Create a new form or edit an existing one
3. Access the **Service catalog** tab

   <div align="left"><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FQIs52PRP9WtVNuEmEa93%2Fadding_form_catalog.png?alt=media&#x26;token=87bbb000-a852-4954-8461-86b8020967fd" alt="Form Service catalog tab"></div>

**Step 2: Catalog Configuration**

**Catalog Information**:

| Field            | Description           | Usage                           |
| ---------------- | --------------------- | ------------------------------- |
| **Description**  | Rich HTML description | Displayed in service card       |
| **Illustration** | Service image         | Card visual (400x300px)         |
| **Category**     | Associated category   | Hierarchical organization       |
| **Pin to top**   | Priority service      | Displayed first, non-filterable |

![Catalog metadata configuration](https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FGRczveMAP16ZuVduvAO3%2Fsetup_option_form.png?alt=media\&token=e07370eb-45bd-4e73-9763-a928d294f470)

**Step 3: Advanced Metadata**

**Optimized description**:

* Use rich editor for formatting
* Avoid images (not supported)
* Keep concise (3-4 lines max)
* Include keywords for search

**Custom illustration**:

* Integrated illustration selector
* Default icon library
* Custom image upload

<figure><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FzjRWH2vblpFklzjoEHi9%2Fadd_custom_image.png?alt=media&#x26;token=d3de86b9-486c-46ce-83c6-9d416c9f74bd" alt=""><figcaption><p>Upload your illustration</p></figcaption></figure>

#### Access Rights Management

**Form Access Control**:

* Uses GLPI access control system
* Checks logged-in user rights
* Automatically filters inaccessible forms
* Supports entities and recursivity

**Rights Configuration**:

1. Access the form's **Access control** tab
2. Define access criteria (profiles, entities, etc.)
3. Test with different user accounts

   <div align="left"><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FbUJ2oSDseAaKGhYxqlki%2Faccess_control_form.png?alt=media&#x26;token=ed7b08f6-2bcc-4433-9cf1-301d38423b2f" alt="Access control tab"></div>

***

### User Experience

#### Catalog Navigation

**Catalog Access**

1. Log in to the GLPI user interface
2. Navigate directly to `/ServiceCatalog` or access via the `+ Create a ticket` button

![Access to the Service catalog](https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FJYVBDrORP1rhMHyZm9Q1%2Fcreate_ticket_by_catalog.png?alt=media\&token=7e7adb6d-9108-4ec2-83bb-acd790c98a0b)

<figure><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FeUWqaD6wrHfR3iSg904a%2Fview_all_categories_catalog.png?alt=media&#x26;token=7b74fd5b-e498-4155-b118-572dbdb9424e" alt=""><figcaption><p>Service catalog homepage</p></figcaption></figure>

#### Search Features

**Search bar**:

* **Fuzzy search**: Typo tolerance
* **Real-time search**: Instant filtering
* **Search fields**: Service name and description
* **Pinned services**: Always visible, non-filtered

**Search examples**:

* `computr` → finds "Computer request"
* `install` → finds "Software installation"
* `hardware` → finds all services in "Hardware" category

#### Sort Options

**Available strategies**:

| Icon | Strategy             | Description     |
| ---- | -------------------- | --------------- |
| 🔤   | Alphabetical         | A → Z by name   |
| 🔤↓  | Reverse alphabetical | Z → A by name   |
| ⭐    | Popularity           | Most used first |

<div align="left"><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FtZf0j4OHGVb96qDaE0Hv%2Fsort_by.png?alt=media&#x26;token=6ebe4224-1a49-42f7-98b4-056b22ef525b" alt="Sort options dropdown"></div>

**Popularity sort**:

* Based on usage count;
* Highlights popular services;
* Useful for identifying recurring needs;

### Advanced Features

#### Knowledge Base Integration

**Automatic display**:

* Knowledge base articles integrated in catalog
* User access rights filtering
* Unified search (forms + articles)

**Configuration**:

1. Edit the concerned knowledge base;
2. **Service catalog** tab;
3. Check activation toggle ☑️;

   <div align="left"><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FVW9XvTQk7lDpBhxMoCpw%2Fservice_catalog_KB.png?alt=media&#x26;token=7355f6f6-114f-4ecc-a9ec-b83fdd921a9d" alt="Service catalog form for KB"></div>

### Pinned Services

**Feature**:

* Priority services always visible;
* Not affected by search filters;
* Positioned first in display;

**Configuration**:

1. Edit the concerned form;
2. **Service catalog** tab;
3. Check **Pin to top** ☑️;

   <div align="left"><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2F52lwbzy84x5lSkCEdO3c%2Fpin_kb_catalog_service.png?alt=media&#x26;token=633440c1-acc2-4841-a7e9-a8e6be91762e" alt="Pin to top configuration"></div>

***

### Administration and Rights

#### Required Rights

**Administrator**:

* **Entities**: Service catalog configuration per entity;
* **Forms**: Form creation and management;
* **Categories**: Category hierarchy management;

**Service Manager**:

* **Forms**: Service catalog metadata modification;
* **Categories**: Creation within entity scope;

**End User**:

* **Assistance**: Read-only service catalog access;
* **Forms**: Form submission according to access rights.

<br>

<br>
