# Setting Up Channel Messages

The welcome message functionality makes GateKeeper send a message to a channel when a user joins your server and accepts the rule screening (if it is enabled).

{% tabs %}
{% tab title="Enable and Edit" %}

```
/welcome enable <channel>
```

Adding a welcome message is simple. Run the command with your target channel, then choose plain message or embed mode. GateKeeper opens a setup modal for the remaining fields.

Important checks before saving

1. Channel must be a text channel
2. GateKeeper must have send messages permission
3. If embed mode is enabled, GateKeeper must have embed links permission

**Placeholder support**

* The setup currently supports `{user}` to mention the member who joined.

Embed modal fields

1. Title optional
2. Message required
3. Show profile picture optional values yes or no
4. Image URL optional and must be an Imgur URL ending in png jpg jpeg or gif
5. Colour optional and must be a six character hex value without `#`
   {% endtab %}

{% tab title="Disable" %}

```
/welcome disable
```

Stops the welcome message from being sent in this server.
{% endtab %}

{% tab title="Show Configuration" %}

```
/welcome show-config
```

Shows the current setup including channel, message mode, and embed values.
{% endtab %}
{% endtabs %}


---

# 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.gatekeeperbot.net/welcome-message/enabling-disabling-message.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.
