# Setting up Welcome

{% hint style="info" %}
Replace `[prefix]` with your server's prefix.
{% endhint %}

{% hint style="success" %}
When setting up help messages, you can use `embedsetup` to easily generate scripts/codes that are compatible with serenity.
{% endhint %}

## Creating a welcome channel

1. Head over to your Discord Server

   Click on the Discord Server that you would like to setup welcome for using serenity.
2. Create the channel

   Setup permissions for the channel with the desired name, for this example we will be using `#welcome`

## Creating an Embed and setting the Welcome Channel

1. **Creating the Welcome Embed**

   Run the `[prefix]embedsetup` command to create the welcome embed which you can use variables with, for more information regarding variables click [here](https://docs.serenity.wtf/embeds/content-in-embeds/variables).
2. **Setup the Welcome Channel**

   Run the `[prefix]welcome add` command which will give you further information.

```
// Syntax
[prefix]welcome add [channel] [code]

// Example
[prefix]welcome add #welcome {embed}{title: Welcome!}$v{author:{user.name}}
```

<figure><img src="https://2138524749-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKC3Q8gA6avaSjTCmPTwv%2Fuploads%2FKuYrUeu5H1h6qrCbCsPF%2Fimage.png?alt=media&#x26;token=e6fd9aae-1eb6-4983-8acc-af616bc9cda1" alt=""><figcaption></figcaption></figure>

## Creating Temporary Welcome Embeds

To create a temporarly welcome Embed you just need to add to your embed code folllowing param: `$v{delete: seconds}`

```
// Example
[prefix]welcome add #welcome {embed}{description: test}$v{delete: 5}
```

## Remove Welcome Embeds

If you wish to remove the welcome system from a channel, or you want to remove all embeds on the current server you can run:

```
// Remove a specific Welcome Embed
[prefix]welcome remove #welcome

//Remove all Welcome Embeds from the Server
[prefix]welcome reset
```

<figure><img src="https://2138524749-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKC3Q8gA6avaSjTCmPTwv%2Fuploads%2FGzqbjK4wV00R3BQUiQkP%2Fimage.png?alt=media&#x26;token=6c57cdde-1f46-47e3-9476-75e1417b4a3d" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.serenity.wtf/get-started/welcome-and-leave/setting-up-welcome.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
