# Custom HTML

### Custom HTML Editor

Send With SES has a Custom HTML Editor in addition to the inbuilt Email Designer.&#x20;

The inbuilt Email Designer is easy to use and suits a wide variety of email sending needs. The Custom HTML Editor is for those who want a unique email template to suit their corporate branding needs.&#x20;

![](/files/-MhlrhsbD_fV5DNfOxbE)

You can compose your HTML within the Custom HTML Editor or copy paste HTML content that you have created elsewhere. You can also create a Custom HTML Template which you can trigger via an API call.

### Replace Tags (aka Merge Tags)

Send With SES supports **Replace Tags (aka Merge Tag)**. A REPLACE TAG is indicated by a unique name within **double-curly-braces**, like so ... **{{password-reset-link}}**. You can use as many REPLACE TAGS as needed. When sending email, the content within the double-curly-braces will be replaced by the content you send via your API call. Image below illustrates.

![](/files/-LYBd5gwC3weKEc2r7HU)

### Name Replace Tag \[\[name]]

Send With SES has a **'one-of-a-kind'** replace tag called **\[\[name]]**. This replaces the **\[\[name]]** in your email template with the **Full Name** associated with your Contact. This allows you to send more personal emails to your users.

{% hint style="info" %}
The Name Replace Tag must **STRICTLY** be lower case **name** in **double square brackets** like below.

### **\[\[name]]**

{% endhint %}

![](/files/-MhlvvS1OvB9ZUNB8AH8)

In the above template&#x20;

&#x20;    Hi \[\[name]],

&#x20;    is replaced by

&#x20;    Hi John Doe, (if your contact has a name attached to it)

(or)

&#x20;     Hi,  (if your contact does not have a name attached to it)

{% hint style="warning" %}
**NOTE: Name Replace Tag does not work with 'Test Emails'.**
{% endhint %}

### Custom HTML - One More Way

In additional to the Custom HTML Editor, there is another way send your custom HTML emails. While we do not recommend it, here's how you can do it in case you really need it ...

**1.Create a blank template with just one 'replace tag' {{custom\_html}} like below ...**

![](/files/-MQemhi4VCf6X_nfIiL7)

**2. Compose your custom HTML using any HTML editor.**&#x20;

**3. Replace {{custom\_html}} in above template with your custom HTML when triggering an email via the** [**API**](https://docs.sendwithses.com/api/send-email-via-api)**.**&#x20;

{% hint style="danger" %}

#### IMPORTANT: HTML for emails is quite tricky as different email clients render HTML differently. So you need to thoroughly test your HTML content with a tool like Litmus.

{% endhint %}


---

# 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.sendwithses.com/how/send-email/custom-html.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.
