# 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 %}


---

# 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://guide.letters.gov.sg/for-agency-users/creating-letter-templates.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.