# Branding

## Requirements (self-hosted)

| GLPI Version | Minimum PHP | Recommended |
| ------------ | ----------- | ----------- |
| 10.0.x       | 8.1         | 8.2         |
| 11.0.x       | 8.2         | 8.4         |

{% hint style="info" %}
A [GLPI Network BASIC](https://services.glpi-network.com/#offers) subscription (or higher) is required. This plugin is also available for all GLPI Network [Cloud instances](https://glpi-network.cloud).
{% endhint %}

***

## Install the plugin

* Go to the marketplace. Download and install the **Branding** plugin.

<div align="left"><figure><img src="/files/qEfJiGNOR2UNTMyUQGLA" alt="images/branding-1.png"><figcaption><p>Download the plugin</p></figcaption></figure></div>

***

## Custom palette

### Customization

**With GLPI 11 only**, you can customize the GLPI 11 theme to your liking.&#x20;

* From **`Tools`** > **`Custom palettes`**, click **`+Add`**
* Name it and click on **`+Add`**
* Select dark or light theme. Each of these themes can, of course, have a different color palette.

From here, you can modify several GLPI theme options:

| Option                            | CSS variable             |
| --------------------------------- | ------------------------ |
| Buttons and highlights            | --tblr-primary           |
| Text on secondary buttons         | --tblr-secondary-fg      |
| Read-only and disabled fields     | --tblr-input-disabled-bg |
| Left menu background              | --tblr-mainmenu-bg       |
| Secondary buttons background      | --tblr-secondary         |
| Text fields, dropdowns, textareas | --tblr-input-bg          |
| All clickable links               | --tblr-link-color        |
| Left menu text and icons          | --tblr-mainmenu-fg       |

You can then customize the item's color using the available color palette

<div align="left"><figure><img src="/files/3rYw0R9n61IZ2XlbVe9H" alt=""><figcaption><p>seen from the color palette</p></figcaption></figure></div>

### Preview

Click on preview to see the result of your customization.

<figure><img src="/files/gQezTpYwjl3bNK2FP9iB" alt=""><figcaption><p>Preview your theme</p></figcaption></figure>

### Force&#x20;

You can force the palette to be applied to all users, even if they have defined a palette in their preferences.

<figure><img src="/files/jh43FKiE6tG80WArDWRu" alt=""><figcaption><p>Force your palette</p></figcaption></figure>

***

## Customize your instance

* Go to **`Administration`** > **`Entities`** > **`Branding`** tab

Here you can replace :

* the logo at top left (including folded bar)
* the logo on the login page,
* the background of the login page,
* the icon in the browser bar

<figure><img src="/files/rGuWPIbcVjkMYh7q0avy" alt="images/branding-2.png"><figcaption><p>Customize your logos</p></figcaption></figure>

***

## Custom by entity

You can modify certain elements by entity:

* the logo at top left (including folded bar)
* the icon in the browser bar

<figure><img src="/files/r1ErEwrEOrAJtO5fZHxG" alt="images/branding-3.png"><figcaption><p>Custom by entity</p></figcaption></figure>

Other customisations are common to all entities

***

## Recommendations

* **Top Left corner logo** - This can be changed according to the desired entity It is the logo you see when your GLPI page is opened and the left sidebar is expanded

Default recommended size: **100x55 pixels**

* **Lop Left corner logo** (collapsed sidebar) - This can be changed according to the desired entity It is the logo you see when your GLPI page is opened and the left sidebar is collapsed.

Default recommended size **40x40 pixels**

* **Favicon** It is the logo you see next to the page title at the beginning of your browser's the tab.

Default recommended size: **16x16 or 32x32 pixels**

* **Login page logo** It is the logo you see before you login. It appears with the fields to fill with your username and password

Default recommended size: **220x130 pixels**

* **Login page background** It is the image you can add as a background at the login page.

Default recommended size: **It depends on the usual size of your screens**. The bigger, the better. (Make sure not to surpass the maximum upload limit for files)

***

## FAQ

If you have any questions about using the plugin, please consult our FAQ

<a href="/spaces/SvoJ3lioglS2UZLcWWyP/pages/2tLjVgCPcLSjsC59kIFJ" class="button secondary">Go to FAQ</a>


---

# 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://help.glpi-project.org/doc-plugins/plugin-glpi-network/branding.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.