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

# Birthdays

> Announce member birthdays and hand out a role for the day.

Members set their own birthday; mira announces it and optionally grants a role for 24 hours.

## For members

<CodeGroup>
  ```javascript Set yours theme={null}
  !birthday set March 14
  ```

  ```javascript Check yours theme={null}
  !birthday
  ```

  ```javascript Check someone else's theme={null}
  !birthday @someone
  ```

  ```javascript Who's coming up theme={null}
  !birthday list
  ```
</CodeGroup>

Aliases: `bday`, `bd`. Dates are flexible — `March 14`, `14 March`, `3/14` and `14/03` all parse. The **year is never stored**, so nobody's age is exposed.

Birthdays fire in the member's [timezone](/utility/everyday#timezones) if they've set one, otherwise the server's.

## Setting it up

<Steps>
  <Step title="Pick an announcement channel">
    ```javascript theme={null}
    !birthday channel #general
    ```

    Requires **Manage Channels**.
  </Step>

  <Step title="Add a role for the day (optional)">
    ```javascript theme={null}
    !birthday role @Birthday
    ```

    Granted at midnight, removed 24 hours later. Requires **Manage Roles**.
  </Step>

  <Step title="Write the message (optional)">
    ```javascript theme={null}
    !birthday message {content: 🎂 happy birthday {user.mention}!}
    ```

    Requires **Manage Messages**. Full [script](/scripting/overview) support.
  </Step>
</Steps>

```javascript theme={null}
!birthday settings
```

Shows the channel, role and message. Requires **Manage Server**.

<Tip>
  Give the birthday role a bright colour and hoist it, so the person shows up at the top of the member list all day. It's a small thing people genuinely like.

  ```javascript theme={null}
  !role color @Birthday #ffd700
  !role hoist @Birthday
  ```
</Tip>

## Command reference

| Command                      | Permission      | Description          |
| ---------------------------- | --------------- | -------------------- |
| `birthday [member]`          | —               | View a birthday      |
| `birthday set <date>`        | —               | Set yours            |
| `birthday list`              | —               | Upcoming birthdays   |
| `birthday channel <channel>` | Manage Channels | Announcement channel |
| `birthday role <role>`       | Manage Roles    | Role for the day     |
| `birthday message <script>`  | Manage Messages | Announcement message |
| `birthday settings`          | Manage Server   | View configuration   |