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

# Placeholders

> Every value you can pull into a script, from usernames to Last.fm scrobbles.

A placeholder is replaced with a real value when the message is sent.

```text Example theme={null}
{member.display_name} joined on {member.joined_at}
```

Many placeholders have a short form. `{user}` and `{member.name}` give you the same thing.

<Warning>
  A placeholder only works where the value exists. Track and artist placeholders need something
  playing, so putting `{track.name}` in a welcome message leaves it **sitting in the message as
  raw text**.
</Warning>

## User

Whoever the message is about, which is usually the member who joined, left, or ran the command.

| Placeholder               | Description                                      | Example                            |
| ------------------------- | ------------------------------------------------ | ---------------------------------- |
| `{member.name}`           | Username                                         | `hellofaman`                       |
| `{member.id}`             | User ID                                          | `345462882902867969`               |
| `{member.display_name}`   | Server display name                              | `faman`                            |
| `{member.global_name}`    | Global display name                              | `faman`                            |
| `{member.mention}`        | Ping mention                                     | `@hellofaman`                      |
| `{member.avatar}`         | Avatar URL                                       | `https://cdn.discordapp.com/…`     |
| `{member.display_avatar}` | Server avatar, falling back to the normal one    | `https://cdn.discordapp.com/…`     |
| `{member.created_at}`     | When the account was made, as a unix timestamp   | `1502435169`                       |
| `{member.joined_at}`      | When they joined the server, as a unix timestamp | `1748054871`                       |
| `{member.join_position}`  | What number member they are                      | `2`                                |
| `{member.top_role}`       | Their highest role name                          | `Admin`                            |
| `{member.roles}`          | Every role name, separated by commas             | `Admin, Member`                    |
| `{member.role_ids}`       | Every role ID, separated by commas               | `12345, 67890`                     |
| `{member.status}`         | Presence                                         | `online`, `offline`, `idle`, `dnd` |

## Server

| Placeholder                           | Description                                   | Example                        |
| ------------------------------------- | --------------------------------------------- | ------------------------------ |
| `{server.name}`                       | Server name                                   | `Mira Platoon`                 |
| `{server.id}`                         | Server ID                                     | `1375666579362156575`          |
| `{server.description}`                | Server description                            | `Official mira support server` |
| `{server.icon}`                       | Server icon URL                               | `https://cdn.discordapp.com/…` |
| `{server.owner_id}`                   | Owner's user ID                               | `345462882902867969`           |
| `{server.member_count}`               | How many members are in the server            | `44`                           |
| `{server.created_at}`                 | When the server was made, as a unix timestamp | `1748054871`                   |
| `{server.premium_tier}`               | Boost level                                   | `0` to `3`                     |
| `{server.premium_subscription_count}` | How many boosts are active                    | `1`                            |
| `{server.vanity}`                     | Vanity code                                   | `mira`                         |
| `{server.vanity_url}`                 | Full vanity link                              | `https://discord.gg/mira`      |
| `{server.afk_timeout}`                | AFK timeout in seconds                        | `300`                          |

## Channel

The channel the message is being sent in.

| Placeholder                    | Description                                    | Example                          |
| ------------------------------ | ---------------------------------------------- | -------------------------------- |
| `{channel}` / `{channel.name}` | Channel name                                   | `general`                        |
| `{channel.id}`                 | Channel ID                                     | `1445250506497855568`            |
| `{channel.mention}`            | Clickable channel link                         | `<#1445250506497855568>`         |
| `{channel.jump_url}`           | Direct link to the channel                     | `https://discord.com/channels/…` |
| `{channel.created_at}`         | When the channel was made, as a unix timestamp | `1764644972`                     |
| `{channel.nsfw}`               | Whether it's marked NSFW                       | `0` or `1`                       |
| `{channel.slowmode_delay}`     | Slowmode in seconds                            | `0`                              |

## Last.fm

These need a linked Last.fm account.

### Profile

| Placeholder        | Description                | Example                               |
| ------------------ | -------------------------- | ------------------------------------- |
| `{lastfm.name}`    | Last.fm username           | `ILLLLLIIIIlllII`                     |
| `{lastfm.url}`     | Profile link               | `https://www.last.fm/user/…`          |
| `{lastfm.avatar}`  | Profile picture URL        | `https://lastfm.freetls.fastly.net/…` |
| `{lastfm.plays}`   | Total scrobbles            | `71,437`                              |
| `{lastfm.artists}` | How many different artists | `2,425`                               |
| `{lastfm.albums}`  | How many different albums  | `6,763`                               |
| `{lastfm.tracks}`  | How many different tracks  | `13,055`                              |

### Now playing

| Placeholder           | Description               | Example                               |
| --------------------- | ------------------------- | ------------------------------------- |
| `{track.name}`        | Track title               | `Ski What It Be`                      |
| `{track.url}`         | Track page on Last.fm     | `https://www.last.fm/music/…`         |
| `{track.duration}`    | How long the track is     | `2:15`                                |
| `{track.plays}`       | Your plays of this track  | `7`                                   |
| `{track.image}`       | Track artwork URL         | `https://lastfm.freetls.fastly.net/…` |
| `{track.spotify_url}` | Spotify link              | `https://open.spotify.com/track/…`    |
| `{artist.name}`       | Artist name               | `Lucki`                               |
| `{artist.url}`        | Artist page on Last.fm    | `https://www.last.fm/music/…`         |
| `{artist.image}`      | Artist image URL          | `https://lastfm.freetls.fastly.net/…` |
| `{artist.plays}`      | Your plays of this artist | `0`                                   |
| `{album.name}`        | Album title               | `Gemini!`                             |
| `{album.url}`         | Album page on Last.fm     | `https://www.last.fm/music/…`         |
| `{album.cover}`       | Album art URL             | `https://lastfm.freetls.fastly.net/…` |

<Tip>
  Timestamps come out as unix numbers. Wrap one in Discord's own timestamp format to get a date
  that updates itself, like `<t:{member.created_at}:R>` for "3 years ago".
</Tip>