# Placeholders

{% hint style="info" %}
All text between the less-than and greater-than signs (**<>**) is a placeholder/variable, replace it with the requested value without the less-than and greater-than signs (**<>**).
{% endhint %}

### PlaceholderAPI Placeholders

**DeluxeTags** plugin provides [**PlaceholderAPI** ](https://www.spigotmc.org/resources/6245/)placeholders that you can use in any plugin that supports [**PlaceholderAPI**](https://www.spigotmc.org/resources/6245/).

| Placeholder                         | Return Value | Description                                                           |
| ----------------------------------- | ------------ | --------------------------------------------------------------------- |
| %deluxetags\_tag%                   | Text         | Returns the player's current tag.                                     |
| %deluxetags\_amount%                | Number       | Returns the total of the player's available tags.                     |
| %deluxetags\_order%                 | Number       | Returns the player's current tag's order.                             |
| %deluxetags\_description%           | Text         | Returns the player's current tag's description.                       |
| %deluxetags\_identifier%            | Text         | Returns the player's current tag's identifier.                        |
| %deluxetags\_tag\_\<TagID>%         | Text         | Returns the specified tag.                                            |
| %deluxetags\_order\_\<TagID>%       | Number       | Returns the specified tag's order.                                    |
| %deluxetags\_description\_\<TagID>% | Text         | Returns the specified tag's description.                              |
| %deluxetags\_has\_tag\_\<TagID>%    | Boolean      | Returns whether if the player has access to the specified tag or not. |

### **Download**

**There is no need to download the expansion anymore!** The expansion was moved inside the plugin itself in the 1.8.2 update which means less work for you! As long as you have PlaceholderAPI installed, the expansion will register automatically.

### **Internal Placeholders**

**DeluxeTags** provides internal placeholders that you can use inside DeluxeTags's GUI and messages.

| Placeholder               | Return Value | Description                                                                                                     |
| ------------------------- | ------------ | --------------------------------------------------------------------------------------------------------------- |
| %player%                  | Text         | Returns the player's name.                                                                                      |
| %displayname%             | Text         | Returns the player's display name.                                                                              |
| %deluxetags\_tag%         | Text         | Returns the tag.                                                                                                |
| %deluxetags\_identifier%  | Text         | Returns the tag's identifier.                                                                                   |
| %deluxetags\_description% | Text         | Returns the tag's description.                                                                                  |
| %deluxetags\_amount%      | Number       | Returns the tag's amount.                                                                                       |
| %deluxetags\_available%   | Text         | Returns the configured text (messages.yml) based on whether the player has access to the tag or not.            |
| %previous\_page%          | Number       | Number of the previous page if there  is one (works inside the GUI only).                                       |
| %current\_page%           | Number       | Number of the current page (works inside the GUI only).                                                         |
| %next\_page%              | Number       | Number of the next page if there  is one (works inside the GUI only).                                           |
| %page%                    | Number       | Number of next or previous page if there is one(Only works inside the gui on the next and previous page items). |


---

# 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://wiki.helpch.at/helpchat-plugins/deluxetags/placeholders.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.