> For the complete documentation index, see [llms.txt](https://docs.ohalee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ohalee.com/products/ultimateguilds/placeholders.md).

# Placeholders

UltimateGuilds registers a **PlaceholderAPI** expansion under the identifier `guilds`. Install [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) and the placeholders below resolve against the guild of the player they are parsed for.

{% hint style="info" %}
If the player is not in a guild, `%guilds_inguild%` returns `false` and most placeholders fall back to a configurable "guild not found" message. `%guilds_tag%` has its own fallback when the player has no guild or the guild has no tag.
{% endhint %}

<table><thead><tr><th width="300">Placeholder</th><th>Description</th></tr></thead><tbody><tr><td>%guilds_inguild%</td><td><code>true</code> / <code>false</code> — whether the player is in a guild</td></tr><tr><td>%guilds_name%</td><td>The guild's name</td></tr><tr><td>%guilds_tag%</td><td>The guild's tag</td></tr><tr><td>%guilds_leader%</td><td>Username of the Guild Master</td></tr><tr><td>%guilds_members%</td><td>Total number of members</td></tr><tr><td>%guilds_online%</td><td>Number of members currently online</td></tr><tr><td>%guilds_invites%</td><td>Number of pending invites</td></tr><tr><td>%guilds_description%</td><td>The guild's description</td></tr><tr><td>%guilds_level%</td><td>The guild's level</td></tr><tr><td>%guilds_xp%</td><td>The guild's current experience</td></tr><tr><td>%guilds_multiplier%</td><td>The guild's multiplier</td></tr><tr><td>%guilds_maxmembers%</td><td>The guild's maximum member capacity</td></tr><tr><td>%guilds_id%</td><td>The guild's internal id</td></tr><tr><td>%guilds_created%</td><td>Creation timestamp (raw)</td></tr><tr><td>%guilds_created_formatted%</td><td>Creation date formatted with <code>date-format</code> from the config</td></tr></tbody></table>