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

# Booster messages

> Thank members who boost your server with an announcement in the channel of your choice.

Bloom can post a message every time someone boosts your server, filled in with their name, your server details, and the current boost count.

## Defaults

| Setting          | Default      | Meaning                                                                      |
| ---------------- | ------------ | ---------------------------------------------------------------------------- |
| Booster messages | On, but idle | Enabled by default, but nothing sends until a channel and a message are set. |
| Booster channel  | Not set      | No channel, so no announcement is sent.                                      |
| Self-destruct    | Off          | Booster messages stay in the channel.                                        |

## Quick start

<Steps>
  <Step title="Set the booster channel">
    Run `!booster #boosts`. Bloom confirms the channel and enables booster messages. Bloom must be able to Send Messages and Embed Links there.
  </Step>

  <Step title="Choose a message">
    Run `!booster template` to pick a ready-made design, or `!booster paste` to supply your own embed code. Bloom previews it and asks you to confirm before saving.
  </Step>

  <Step title="Preview it">
    Run `!boostertest`. Bloom renders the message using your own account as the sample booster.
  </Step>
</Steps>

## Configuring the message

<ParamField path="booster" type="Administrator">
  Configures the booster message. Run with no argument to see the current status. Aliases: `setbooster`, `boostermsg`.

  * `!booster #channel` sets the channel and enables booster messages.
  * `!booster template` lists ready-made designs and saves the one you pick.
  * `!booster paste` prompts you to send your own embed code, previews it, and saves it on confirmation.
  * `!booster test` previews the saved message using your account as the sample.
  * `!booster enable` and `!booster disable` turn announcements on or off without deleting the configuration.
  * `!booster convert` upgrades a legacy message to the modern format.
</ParamField>

<ParamField path="boostertest" type="Administrator">
  Renders the saved booster message as it would appear for a real boost, using your own account. Alias: `testbooster`.
</ParamField>

Booster messages use the same `$e{...}` embed format as the rest of Bloom, and support **every welcome variable** plus the boost specific tokens. See [Variables and placeholders](/reference/variables#booster-messages) for the full list and [Embed syntax](/reference/embeds) for the format itself.

```text A booster announcement that pings the member theme={null}
{message: Thank you {user.mention}!}$e{title: New boost}$e{description: {user} just boosted {guild.name}, taking us to {guild.boosts} boosts.}$e{thumbnail: {user.avatar}}$e{color: #f47fff}
```

### Auto-delete booster messages

<ParamField path="booster selfdestruct <duration|off>" type="Administrator">
  Deletes each announcement a set time after it is sent, to keep the channel clean.

  * **Accepted values:** a duration such as `30s`, `5m`, or `1h`. The minimum is 5 seconds and the maximum is 1 hour.
  * Use `off` to disable it, so announcements stay in the channel.
</ParamField>

### Legacy format and conversion

Bloom accepts two message formats. The **modern** format uses `$e{...}` blocks. An older **YAML** format writes one `key: value` per line. Both work.

<ParamField path="booster convert" type="Administrator">
  Converts a saved YAML message to the modern `$e{...}` format, previews the result, and saves it on confirmation. Your original is left unchanged if you cancel.
</ParamField>

## Personal roles for boosters

Announcing a boost and giving the booster a role of their own are separate features. To let boosters create and style their own role, see [Booster and custom roles](/configuration/roles/personal-roles).

## Troubleshooting

<AccordionGroup>
  <Accordion title="No announcement appeared when someone boosted">
    Check `!booster` with no arguments. A channel must be set and a message saved before anything sends, and Bloom needs Send Messages and Embed Links in that channel.
  </Accordion>

  <Accordion title="The message sent but the variables came out blank">
    A token that does not exist for booster messages is left as written or filled with nothing. Check your tokens against the [booster message variables](/reference/variables#booster-messages).
  </Accordion>

  <Accordion title="The announcement disappeared shortly after sending">
    Self-destruct is on. Run `!booster selfdestruct off` to keep announcements in the channel.
  </Accordion>

  <Accordion title="The test looks right but real boosts look different">
    `boostertest` uses your own account as the sample. Tokens that depend on the boost itself, such as the new boost count, show your server's live values rather than the values at the moment of a real boost.
  </Accordion>
</AccordionGroup>

## Related pages

<CardGroup cols={2}>
  <Card title="Booster and custom roles" icon="paintbrush" href="/configuration/roles/personal-roles">
    Let boosters build a personal role with their own name and color.
  </Card>

  <Card title="Welcome messages" icon="door-open" href="/configuration/welcome">
    The same message format and commands, for members joining.
  </Card>

  <Card title="Variables and placeholders" icon="brackets-curly" href="/reference/variables#booster-messages">
    Every token a booster message can use.
  </Card>

  <Card title="Embed syntax" icon="code" href="/reference/embeds">
    The format booster messages are written in.
  </Card>
</CardGroup>