# Creating Letter Templates

{% hint style="warning" %}
**From 8 Sep 2025:** New LetterSG users will not be allowed to create, edit, or clone templates till further notice.
{% endhint %}

## How do I create a template on LetterSG?

1. Navigate to the "Template Library" section. Under Template Library, select "Create from our available templates"

   <figure><img src="https://4097645561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGChNUU8J3OerY8QoGh6%2Fuploads%2FCOQYJ7TZ5UTshjuKny9y%2FScreenshot%202024-08-26%20at%209.30.58%E2%80%AFAM.png?alt=media&#x26;token=2fa9b53a-0944-49e1-9585-c46d832607a7" alt=""><figcaption></figcaption></figure>
2. You should be able to see a range of pre-designed layouts that you are able to choose from.&#x20;

   <figure><img src="https://4097645561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGChNUU8J3OerY8QoGh6%2Fuploads%2F9XlyuFjphLnuG85fIc7j%2FScreenshot%202024-08-15%20at%2010.27.52%E2%80%AFPM.png?alt=media&#x26;token=5178cea1-9d8f-43bf-90f2-ae7fa1440fb5" alt=""><figcaption></figcaption></figure>
3. Choose a template layout relevant to your usecase, for example a letter, notification, or certificate. You should be able to preview the layout when you select the layout card.&#x20;

   <figure><img src="https://4097645561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGChNUU8J3OerY8QoGh6%2Fuploads%2FsrcHXjdOoRBg4AWmoImh%2FScreenshot%202024-08-15%20at%2010.30.54%E2%80%AFPM.png?alt=media&#x26;token=b15d1901-0e5f-4a30-b7e8-6952de108aed" alt=""><figcaption></figcaption></figure>
4. Select the layout you want to proceed with, and click "Start with this". The template editor should open with your selected template layout. You are able to customise the content of your template within the editor.&#x20;

   <figure><img src="https://4097645561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGChNUU8J3OerY8QoGh6%2Fuploads%2FMkxStZaSANDo21OjwqOL%2FScreenshot%202024-08-26%20at%209.13.25%E2%80%AFAM.png?alt=media&#x26;token=7e9cc2d3-f3c8-4d7e-9dcb-47f74508e3bb" alt=""><figcaption></figcaption></figure>

## What can I do with the editor?

Please refer to the section on template editing [here](https://guide.letters.gov.sg/for-agency-users/editing-letter-templates#what-can-i-do-with-the-editor).

<figure><img src="https://4097645561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGChNUU8J3OerY8QoGh6%2Fuploads%2FTip2wVmCIsZMvWAJKcdL%2FScreenshot%202024-08-26%20at%209.15.46%E2%80%AFAM.png?alt=media&#x26;token=35e13cfc-7a34-4b79-862c-3c51714b667b" alt=""><figcaption></figcaption></figure>

## How should I format personalised fields in my letter?

**Guidelines on accepted fields**

* Field names should contain only alphanumerical characters and/or underscore: A-Z, a-z, 0-9,\_
* Field names should not contain whitespace in the middle of variable names: {{ your name }} is invalid.
* Field names should not contain special characters: {{ your\&name }} is invalid.
* Field names can be styled (e.g. italicised/bolded). Ensure that the styling applies to the entire field name, including the curly brackets: **{{&#x20;*****your*****\_name** }} is invalid.

{% hint style="danger" %}
Invalid variables will just be treated as plain text
{% endhint %}