> For the complete documentation index, see [llms.txt](https://bad-word-blocker.gitbook.io/bad-word-blocker-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bad-word-blocker.gitbook.io/bad-word-blocker-docs/customization/embed-customization.md).

# 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&amp;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&amp;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"