# Custom Emails

The **Custom Emails** section allows administrators to manage and personalize automated email templates that are triggered by key platform events.

<figure><img src="https://835503362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxKMBw1IB53ZJ2sltFPC%2Fuploads%2FZexHYn8rkdk5Edi1Xiir%2Fcustom-emails.png?alt=media&#x26;token=6cc224a3-87b3-4b32-a1a2-307a80181389" alt=""><figcaption></figcaption></figure>

These templates are fully editable and support dynamic placeholders to populate user-specific or program-specific data.

## Email Listing Page

This listing view displays all available email templates and their current status. This page includes the following columns:

* **Template** - Internal name of the email event. Each corresponds to a platform trigger (e.g., account creation, payout approved).
* **Subject (Published)** - The subject line from the currently **Published** version of the email. If no version has been published, the **Default** template subject will appear instead.
* **Action** - Dropdown with the following options:
  * **Preview** - Opens a read-only view of the currently published version.
  * **Edit Content** - Opens the editor to customize the email.

{% hint style="info" %}
Published content is what the platform sends to users. Draft changes will not affect live emails until published.
{% endhint %}

## Template Name Mapping

Below is the list of supported email templates along with a brief explanation of when each one is triggered:

| Email Template            | Description                                                                     |
| ------------------------- | ------------------------------------------------------------------------------- |
| **Account Creation**      | Sent when a user's trading account has been successfully created and activated. |
| **KYC Approved**          | Sent when a user's KYC verification is approved.                                |
| **KYC Pending**           | Sent when a user's KYC submission is received and is pending review.            |
| **KYC Rejected**          | Sent when a user's KYC verification is rejected.                                |
| **KYC Submitted**         | Sent to confirm that the user has successfully submitted their KYC documents.   |
| **Payout Approved**       | Sent when a payout request is approved and is being processed.                  |
| **Payout Requested**      | Sent when a user submits a payout request.                                      |
| **Payout Rejected**       | Sent when a payout request is rejected by the admin team.                       |
| **Upgrade Eligible**      | Sent when a user has met the profit target and is eligible for an upgrade.      |
| **Account Breached**      | Sent when a user violates one or more account rules, causing a breach.          |
| **Upgrade Approved**      | Sent when an account upgrade request is approved.                               |
| **Upgrade Pending**       | Sent when an upgrade request has been received and is under review.             |
| **Upgrade Rejected**      | Sent when an upgrade request is rejected.                                       |
| **Competition Joined**    | Sent when a user successfully joins a trading competition.                      |
| **Self Fund Creation**    | Sent when a self-funded user creates their account.                             |
| **Upgrade Approved Cert** | Sent when an upgrade is approved and includes a certificate for the user.       |

{% hint style="info" %}
Templates can be customized per event type and localized into different languages using the language dropdown inside the editor.
{% endhint %}