# Embed Customization

## Customizing the "Message Blocked" Embed

When a message is blocked, Bad Word Blocker sends an embed (unless you have it disabled with the "self destruct counter" option).

It is possible to customize this embed.

You can customize the following aspects:

* **Title**
  * The text that's shown at the very top of the embed 
* **Description**
  * The "body" of the embed. The following placeholders are permitted:
    * `{username}` - The author’s username
    * `{mention}` - The author’s @mention
    * `{content}` - The contents of the deleted message. If you put a word in parathesis after the word `content`, then every usage of a blacklisted item will be replaced with that word. For example, if you put `{content(cheese)}`, then every blacklisted item will be replaced with the word “cheese”.
    * `{strikes}` - The new amount of strikes they have
    * `{strikes_remaining}` - If you have a limit set up, how many strikes are left until they reach the next limit.
    * `{date}` - Date of when the message was deleted
    * `{blacklisted_items}` - The blacklisted items found that caused the deletion of the message
    * `{next_limit_action}` - If you have a limit set up, the action of the next limit
    * `{next_limit_minutes}` - If you have a limit set up, the minutes of the next limit
    * `{next_limit_strikes}` - If you have a limit set up, the strikes of the next limit.

<details>

<summary>Click for custom description example</summary>

<figure><img src="https://3769430690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Poxe128np2xwfpuOkK9%2Fuploads%2FTVSL5zsTc2J1Dqlu5BsL%2Fimage.png?alt=media&#x26;token=6fe75852-74bc-4aa8-9e76-35e8714fa0b0" alt=""><figcaption><p>Custom Description</p></figcaption></figure>

<figure><img src="https://3769430690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Poxe128np2xwfpuOkK9%2Fuploads%2FEGoxwqCuziXpr4CnhG4w%2Fimage.png?alt=media&#x26;token=6b191638-ae7f-4cc7-b528-7bf3619432e3" alt=""><figcaption><p>Resulting Embed</p></figcaption></figure>

</details>

* **Color**
  * The color of the stripe on the left side of the embed
* **Self destruct counter**
  * Set to -1 to never send embed
  * Set to 0 to never delete embed after sending
  * Any value over 1 is amount of seconds before the embed deletes itself. For example, if you set to 5, the embed will be deleted 5 seconds after sending

{% hint style="info" %}
**Premium Users:** Can customize everything

**Free Users:** Can only customize the title and self destruct counter
{% endhint %}

## How to Customize the Embed

{% hint style="success" %}
Only people with `Manage Messages` or `Administrator` permission can customize the embed
{% endhint %}

1. Navigate to your Discord server
2. In any channel, type in `/customize embed`
3. Hit the Enter button if you're on computer. If you're on mobile, hit the send button.
4. Enter the desired values into each field. Refer to previous section.
5. Hit "Submit"


---

# 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://bad-word-blocker.gitbook.io/bad-word-blocker-docs/customization/embed-customization.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.