> ## Documentation Index
> Fetch the complete documentation index at: https://talktohumans.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 📝 Templates and variables

If you often reuse the same message or sequence structure, you can save it as a template instead of rewriting it every time.

TalkToHumans has two kinds of templates:

* **Message templates** for a single message
* **Sequence templates** for a series of messages, connection requests, and delays

<Info>
  Templates are starting points, not campaigns. You apply them to one conversation at a time, review the result, and personalize it before anything is sent.
</Info>

## Use a template

Open a conversation, then click **Sequences** in the composer, or press `;` twice:

<img src="https://mintcdn.com/talktohumans/U8IKJwEVJOjdsGfH/images/talktohumans-schedule.png?fit=max&auto=format&n=U8IKJwEVJOjdsGfH&q=85&s=6446a90546e862233fea6cfa0dcca600" alt="Talktohumans Schedule" width="2560" height="1643" data-path="images/talktohumans-schedule.png" />

From there:

1. Choose **Sequences** or **Messages** (you can switch by pressing `1` or `2`)
2. Click the template you want to use
3. Review the message or every step in the sequence
4. Personalize it for the person you are contacting
5. Send the message or launch the sequence when it is ready

## Personalize templates with variables

Templates can include variables for information such as a contact’s first name, job title, company, or one of your [custom fields](https://www.talktohumans.app/docs/product/contacts/custom-fields).

While writing a template, click the small **+** beside your cursor or type `/` to add a variable:

<img src="https://mintcdn.com/talktohumans/xoazwbx79GU8zYYs/images/composer-custom-variables.png?fit=max&auto=format&n=xoazwbx79GU8zYYs&q=85&s=05b1a6f54d62f706e6b06358253bbd92" alt="Composer Custom Variables" width="1364" height="596" data-path="images/composer-custom-variables.png" />

When you apply the template, TalkToHumans resolves the variables for the person in the current conversation.

If a value is missing or invalid, it is highlighted so you can replace or remove it before sending:

<img src="https://mintcdn.com/talktohumans/U8IKJwEVJOjdsGfH/images/invalid-custom-variable-1.png?fit=max&auto=format&n=U8IKJwEVJOjdsGfH&q=85&s=3c540a1d014d4a5a07112b62d1f1880d" alt="Invalid Custom Variable 1" width="758" height="242" data-path="images/invalid-custom-variable-1.png" />

<Info>
  Variables help with the predictable parts of a message, but they do not make the message relevant on their own.
</Info>

## Create a message template

1. Open the templates menu and select **Messages**
2. Click **Add**
3. Give the template a clear name and optionally add it to a group
4. Write the message and add any variables you need

<img src="https://mintcdn.com/talktohumans/7CPnZjxAea_SLd9A/images/create-template.png?fit=max&auto=format&n=7CPnZjxAea_SLd9A&q=85&s=eabfbe43fc2194558b894845beb40c84" alt="Create Template" width="1552" height="1142" data-path="images/create-template.png" />

<Info>
  Templates are shared within your organization by default
</Info>

## Create a sequence template

There are two ways to create one:

### Create it from the templates menu

1. Open the templates menu and select **Sequence templates**
2. Click **Add**
3. Give the template a clear name and optionally add it to a group
4. Add your connection request, messages, and delays

The sequence editor works the same way it does in a conversation. You can edit, duplicate, delete, and reorder steps, or change a step from a message to a connection request.

### Save a sequence you are already writing

If you’ve already written a sequence worth templatizing, you can save it as a template by opening its settings menu and clicking **Save as template**:

<img src="https://mintcdn.com/talktohumans/7CPnZjxAea_SLd9A/images/sequence-save-as-template.png?fit=max&auto=format&n=7CPnZjxAea_SLd9A&q=85&s=ade03b39f459bf1e6d83d698eb7f892f" alt="Sequence Save As Template" width="752" height="530" data-path="images/sequence-save-as-template.png" />

## Organize your templates

As your library grows, you can **search, group, and reorder your templates.**

### Create groups

Open the menu on any template, select **Add to group**, then choose **New group**.

Click the colored group labels at the top of the templates menu to filter the list:

<img src="https://mintcdn.com/talktohumans/7CPnZjxAea_SLd9A/images/group-templates.png?fit=max&auto=format&n=7CPnZjxAea_SLd9A&q=85&s=a4da4ab14b63c03a86130e9fdffbabd8" alt="Group Templates" width="1372" height="698" data-path="images/group-templates.png" />

## See what gets replies

Once a template has been used, it will show its reply rate:

<img src="https://mintcdn.com/talktohumans/7CPnZjxAea_SLd9A/images/template-reply-rate.png?fit=max&auto=format&n=7CPnZjxAea_SLd9A&q=85&s=779e168991aa3b2918a0222941531d69" alt="Template Reply Rate" width="880" height="650" data-path="images/template-reply-rate.png" />

Useful for seeing which formats tend to work best and iterating from there.

<Info>
  Hover over the rate to see how many times the template has been used
</Info>

## Template shortcuts

| **Action**                       | **Shortcut** |
| :------------------------------- | :----------- |
| **Open or close templates**      | **; ;**      |
| **Switch to sequence templates** | **1**        |
| **Switch to message templates**  | **2**        |

See [Use sequences](https://www.talktohumans.app/docs/product/messaging/sequences) to learn how to personalize and launch a sequence after applying a template.
