> For the complete documentation index, see [llms.txt](https://tooltips.gitbook.io/tooltips/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tooltips.gitbook.io/tooltips/configuration/icon.md).

# Icon

{% hint style="info" %}
You cannot use glyphs / images from other plugins. That's why you have to use the plugins built-in icon system.
{% endhint %}

Icons allow you to add your own custom textures into the tooltip text.

### Base configuration

```yaml
icon-id:
   path: "tooltips:icon.png"
   ascent: 2
   height: 8
   width: 4 # Only use if needed
```

All properties of the icon configuration are required.

#### path

Path to the texture of this icon inside `.../pack`

#### ascent

Vertical offset of this texture. Bigger number = higher, lower = lower.

#### height

Size of this texture. Preferably must be the real pixel height of the texture divided by two.

( if the texture is 16 pixels high, the `height` has to preferably be 8)

**width**

Overriding width, which will manually tell tooltips what it should interpet this icons width to be.

### Usage

Supported in all tooltip related text. Icons can be used by entering their placeholder:

```
{file/icon-id}
```

### Default icons

#### Images

A few default icons are included:

```
/tt sendtheme Septicuss default-one-line Default icons -> {default/gem} {default/box} {default/right-click}
```

<div align="left"><figure><img src="/files/QG2RnCNTLs55CzwUOPhS" alt=""><figcaption></figcaption></figure></div>

#### Spaces

You can also use predefined spaces to move your text around

The format is: <mark style="color:red;">`{+x}`</mark>- for positive offset and <mark style="color:red;">`{-x}`</mark> - for negative offset, where <mark style="color:red;">`x`</mark> is pixels

```
/tt sendtheme Septicuss default-one-line Default icons -> {-16}{default/gem} {default/box} {default/right-click}
```

<div align="left"><figure><img src="/files/rCdVWkTQ02qrQTxCm98S" alt=""><figcaption></figcaption></figure></div>