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

# Variables

> All available variables within Omex

These variables are accessible throughout Omex and can be used in any command context which contains a `message` or `embed code` parameter (for example `welcome`, `leave`, `goodbye`, and `bumpreminder`).

<Tabs>
  <Tab title="User">
    | Variable         | Output                 |
    | ---------------- | ---------------------- |
    | `{user}`         | Author display name    |
    | `{user.name}`    | Author username        |
    | `{user.id}`      | Author user ID         |
    | `{user.mention}` | Mention for the author |
    | `{user.tag}`     | Author tag string      |
    | `{user.avatar}`  | Author avatar URL      |
  </Tab>

  <Tab title="Guild">
    | Variable               | Output             |
    | ---------------------- | ------------------ |
    | `{guild.name}`         | Guild name         |
    | `{guild.id}`           | Guild ID           |
    | `{guild.member_count}` | Guild member count |
    | `{guild.icon_url}`     | Guild icon URL     |
  </Tab>

  <Tab title="Channel">
    | Variable            | Output          |
    | ------------------- | --------------- |
    | `{channel.name}`    | Channel name    |
    | `{channel.id}`      | Channel ID      |
    | `{channel.mention}` | Channel mention |
  </Tab>

  <Tab title="Leveling">
    These variables are available inside **level-up message templates** (`level message <template>`).

    Your level-up template can be plain text or embed script mode (`{embed}`):

    | Variable                       | Output                                     |
    | ------------------------------ | ------------------------------------------ |
    | `{new.level}`                  | New level after leveling up                |
    | `{old.level}`                  | Previous level before leveling up          |
    | `{invisible}`                  | Zero-width spacing character               |
    | `{botcolor}`                   | Bot display color hex (fallback `#2b2d31`) |
    | `{user.joined_at}`             | User join timestamp (Discord formatted)    |
    | `{user.created_at}`            | User account creation timestamp            |
    | `{user.discriminator}`         | User discriminator                         |
    | `{guild.count}`                | Guild member count                         |
    | `{guild.count.format}`         | Guild member count with commas             |
    | `{guild.created_at}`           | Guild creation timestamp                   |
    | `{guild.boost_count}`          | Guild boost count                          |
    | `{guild.booster_count}`        | Guild boost count (alias)                  |
    | `{guild.boost_count.format}`   | Boost count with commas                    |
    | `{guild.booster_count.format}` | Boost count with commas (alias)            |
    | `{guild.boost_tier}`           | Guild boost tier                           |
    | `{guild.vanity}`               | Guild vanity URL (or `none`)               |
    | `{guild.icon}`                 | Guild icon URL                             |

    This tab adds to the shared variables from **User**, **Guild**, and **Channel** above.
  </Tab>

  <Tab title="Moderation Invoke">
    These variables are available inside **invoke/msgconfig templates** for actions: `ban`, `bandm`, `kick`, `kickdm`, `tempban`, `unban`, `timeout`.

    Notes:

    * Works in plain text and embed script mode
    * `invoke` / `msgconfig` is premium-guild only
    * `reason` falls back to your localized “No reason provided” text

    | Variable              | Output                                                  |
    | --------------------- | ------------------------------------------------------- |
    | `{user}`              | Target user object string                               |
    | `{user.name}`         | Target username                                         |
    | `{user.mention}`      | Target mention                                          |
    | `{user.id}`           | Target user ID                                          |
    | `{target}`            | Alias of `{user}`                                       |
    | `{target.name}`       | Alias of `{user.name}`                                  |
    | `{target.mention}`    | Alias of `{user.mention}`                               |
    | `{target.id}`         | Alias of `{user.id}`                                    |
    | `{moderator}`         | Moderator object string                                 |
    | `{moderator.name}`    | Moderator username                                      |
    | `{moderator.mention}` | Moderator mention                                       |
    | `{reason}`            | Action reason                                           |
    | `{action}`            | Action keyword (`banned`, `kicked`, `tempbanned`, etc.) |
    | `{duration}`          | Duration text (for temp actions)                        |
    | `{until}`             | End timestamp text (for temp actions)                   |
    | `{case_id}`           | Case ID (if provided by context)                        |

    This tab also supports shared variables from **Guild** and **Channel** above.
  </Tab>

  <Tab title="Bump Reminder">
    These variables are available inside **bump reminder message templates**.

    | Variable                        | Output                                                          |
    | ------------------------------- | --------------------------------------------------------------- |
    | `{bumpreminder.next_bump}`      | Relative timestamp showing when the next bump will be available |
    | `{bumpreminder.last_user_bump}` | Mention of the previous user who bumped the server              |
    | `{bumpreminder.last_user_name}` | Username of the previous user who bumped                        |
  </Tab>

  <Tab title="Last.fm (Now Playing)">
    These variables are available only in **Last.fm now-playing contexts**.

    | Variable            | Output                                       |
    | ------------------- | -------------------------------------------- |
    | `{track.name}`      | Track name                                   |
    | `{track.url}`       | Track URL                                    |
    | `{track.playcount}` | Track playcount (or `N/A` if unavailable)    |
    | `{track.image}`     | Track image URL (or `N/A` if unavailable)    |
    | `{artist.name}`     | Artist name                                  |
    | `{artist.url}`      | Artist URL                                   |
    | `{album.name}`      | Album name                                   |
    | `{album.url}`       | Album URL                                    |
    | `{album.playcount}` | Album playcount (or `N/A` if unavailable)    |
    | `{album.cover}`     | Album cover URL (or `N/A` if unavailable)    |
    | `{user.name}`       | Last.fm username                             |
    | `{user.id}`         | Last.fm user ID (or `N/A` if unavailable)    |
    | `{user.avatar}`     | Last.fm avatar URL (or `N/A` if unavailable) |
  </Tab>

  <Tab title="Greeting">
    These variables are available inside **greeting message templates**

    | Variable               | Output                        |
    | ---------------------- | ----------------------------- |
    | `{user}`               | Member display name           |
    | `{user.name}`          | Member username               |
    | `{user.id}`            | Member user ID                |
    | `{user.mention}`       | Member mention                |
    | `{user.tag}`           | Member tag (username#discrim) |
    | `{user.avatar}`        | Member avatar URL             |
    | `{guild.name}`         | Server name                   |
    | `{guild.id}`           | Server ID                     |
    | `{guild.member_count}` | Server member count           |
    | `{guild.icon_url}`     | Server icon URL               |
  </Tab>
</Tabs>