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

# Welcome

> Configure welcome messages in your server!

<Expandable title="Permissions">
  <Columns cols={2}>
    <Card title="You">
      `Manage Server`
    </Card>

    <Card title="Caelus">
      * `Manage Server` (for disabling Discord join messages)
      * `Read Message History` (for hugging)
      * `Send Messages`
      * `View Channel`
    </Card>
  </Columns>
</Expandable>

## Setting up welcome messages

Welcome messages are sent whenever someone joins the server. Other applications do this, but Caelus makes it Sky-themed.

Setting them up is easy. Use `/configure welcome`! Once you hit the obvious edit button, a modal will appear asking you to edit a number of things:

<img src="https://mintcdn.com/thatskyapplication/mdpz_Kmpbe3itdNO/images/welcome-modal.webp?fit=max&auto=format&n=mdpz_Kmpbe3itdNO&q=85&s=e0635ba74ac60a5648220e8b0f5f5911" alt="Welcome Modal" title="Welcome Modal" style={{ width:"47%" }} width="626" height="1354" data-path="images/welcome-modal.webp" />

Enter your desired information, and a preview of what the welcome message will look like will be revealed to you!

### Welcome message recommendations

* `{{user}}` mentions the user who joined
  * No other mentions will work, but they will appear correctly
* Mentions don't autocomplete in modals. It is recommended to type it out into a text channel and then cope & paste the contents into the modal
* Custom emojis may be used from the server & Caelus itself

### Disabling Discord join messages

You may have this enabled:

<img src="https://mintcdn.com/thatskyapplication/mdpz_Kmpbe3itdNO/images/discord-system-messages.webp?fit=max&auto=format&n=mdpz_Kmpbe3itdNO&q=85&s=8418c2c4c701b7d8fb01751cfcbff0a8" alt="Discord System Messages" title="Discord System Messages" style={{ width:"74%" }} width="928" height="580" data-path="images/discord-system-messages.webp" />

If left enabled, both Discord and Caelus will trigger for join messages. It is recommended to **disable** the above setting to deduplicate the join messages. Caelus will offer a way to do this for you if Caelus has `Manage Server`, but if Caelus does not have it, you need someone with `Manage Server` to disable that setting.

## Examples

Here are some real examples of how they are used:

<Columns cols={3}>
  <Card title="Sky Sanctuary">
    <img src="https://mintcdn.com/thatskyapplication/mdpz_Kmpbe3itdNO/images/welcome-example-1.webp?fit=max&auto=format&n=mdpz_Kmpbe3itdNO&q=85&s=2d92da3d556ebc5fd377829635a15a93" alt="Welcome Example 1" width="1210" height="1782" data-path="images/welcome-example-1.webp" />
  </Card>

  <Card title="Starfield💫">
    <img src="https://mintcdn.com/thatskyapplication/UzJh36QAJ5IkW70Q/images/welcome-example-2.webp?fit=max&auto=format&n=UzJh36QAJ5IkW70Q&q=85&s=acb81d3d373b437243e2bd03ae2ef24a" alt="Welcome Example 2" width="817" height="1782" data-path="images/welcome-example-2.webp" />
  </Card>

  <Card title="Eve's Daycare">
    <img src="https://mintcdn.com/thatskyapplication/Tr1NgrkYoGnMv533/images/welcome-example-3.webp?fit=max&auto=format&n=Tr1NgrkYoGnMv533&q=85&s=c8b90bfe11ac346db8ba5feaa4c69ff2" alt="Welcome Example 3" width="946" height="1304" data-path="images/welcome-example-3.webp" />
  </Card>
</Columns>