yambar-decorations(5) File Formats Manual yambar-decorations(5)

# [NAME](#NAME)

yambar-decorations - configuration file

# [DESCRIPTION](#DESCRIPTION)

Decorations are optional additions to particles, enabling you to e.g. change the background color of the entire particle, draw an underline and so on.

Decorations are applied to the particle's margins as well.

All decorations define their own configuration attributes, and there are no common attributes.

# [BACKGROUND](#BACKGROUND)

This decoration sets the particles background color.

## [CONFIGURATION](#CONFIGURATION)

**Name** **Type** **Req** **Description** color color yes The background color. See [**yambar**(5)](/man/enterprise-packages/yambar/yambar.5) for format.

## [EXAMPLES](#EXAMPLES)

```
content:


  string:


    deco:


      background:


        color: 00ff00ff
```

# [UNDERLINE](#UNDERLINE)

This decoration renders a line of configurable size and color at the bottom of the particle.

## [CONFIGURATION](#CONFIGURATION~2)

**Name** **Type** **Req** **Description** size int yes The size (height/thickness) of the line, in pixels color color yes The color of the line. See [**yambar**(5)](/man/enterprise-packages/yambar/yambar.5) for format.

## [EXAMPLES](#EXAMPLES~2)

```
content:


  string:


    deco:


      underline:


        size: 2


        color: ff0000ff
```

# [OVERLINE](#OVERLINE)

Similar to *underline*, this decoration renders a line of configurable size and color at the top of the particle.

## [CONFIGURATION](#CONFIGURATION~3)

**Name** **Type** **Req** **Description** size int yes The size (height/thickness) of the line, in pixels color color yes The color of the line. See [**yambar**(5)](/man/enterprise-packages/yambar/yambar.5) for format.

## [EXAMPLES](#EXAMPLES~3)

```
content:


  string:


    deco:


      overline:


        size: 2


        color: ff0000ff
```

# [BORDER](#BORDER)

This decoration renders a border of configurable size (i.e border width) around the particle.

## [CONFIGURATION](#CONFIGURATION~4)

**Name** **Type** **Req** **Description** color color yes The color of the line. See [**yambar**(5)](/man/enterprise-packages/yambar/yambar.5) for format. size int no Border width, in pixels. Defaults to 1px.

## [EXAMPLES](#EXAMPLES~4)

```
content:


  string:


    deco:


      border:


        size: 2


        color: ff0000ff
```

# [STACK](#STACK)

This particles combines multiple decorations.

## [CONFIGURATION](#CONFIGURATION~5)

No configuration attributes available. The *stack* is just a **list** of the decorations that should be combined.

## [EXAMPLES](#EXAMPLES~5)

```
content:


  string:


    deco:


      stack:


        - background: ...


        - underline: ...
```

# [SEE ALSO](#SEE_ALSO)

[**yambar-particles**(5)](/man/enterprise-packages/yambar/yambar-particles.5)

2026-09-18

---

Document: yambar-decorations(5) from yambar 1.11.0-r3 (Chainguard OS)
Source: https://codeberg.org/dnkl/yambar