> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nameplatebuilder.frotty27.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Format Popup

> Choose display formats, prefix/suffix wrapping, and bar styles.

<Info>This documentation is written for **NameplateBuilder >= v4.260326.7** with **API >= v2.2.0**.</Info>

When a segment has multiple display formats (variants), clicking the **Format** button on a chain block opens the format popup.

## Variant Selection

The top of the popup lists all available display variants for that segment. For example, Health might offer:

| Variant                   | Example Output       |
| :------------------------ | :------------------- |
| **Current/Max** (default) | `42/67`              |
| **Percentage**            | `63%`                |
| **Bar**                   | `\|\|\|\|\|\|------` |

Click a variant to select it. The selected variant is highlighted in green. The chain preview updates in real time to show the new format.

## Prefix & Suffix

Below the variant list, two text fields let you wrap the segment output:

* **Before** (prefix) - text prepended to the segment value, e.g. `HP: [`
* **After** (suffix) - text appended to the segment value, e.g. `]`

With the above settings and the Current/Max variant, the output would be: `HP: [42/67]`

## Bar Style

This section is only visible when the selected variant is a **Bar** type. It contains:

* **Empty** - the character used for unfilled segments of the bar. Defaults to `-`

For example, with `Empty: .` the bar would render as `||||||......` instead of `||||||------`.

## Confirm / Cancel

Format changes are previewed live in the chain but are **not saved** until you click **Confirm**. Click **Cancel** to discard changes and revert to the previous format settings.

After confirming, remember to click **Save** in the main editor to persist your changes to disk.