Skip to main content
A message template is a subject and a message your team writes often: an application received, a foster approved, a thank-you. Anybody answering in the inbox or writing in Compose can start from one, then read and change it before it goes.
The Message templates list in RescueConsoleThe Message templates list in RescueConsole

Message templates, with the subject each one sends and whether it is active.

Open it from Settings → Communications → Message templates, or press Templates on Compose or on the Communications log. Anyone who can See Communications can read the templates. Adding, editing and deleting them needs Change on Communications. RescueConsole does not send any template by itself. A template goes out only when somebody chooses it in a reply or in Compose, or when a step of one of your workflows sends it.

The list

The list is in order of name. The Status filter above it shows one status at a time, and the column button chooses which columns you see. Press a row to open that template. Communications log and Compose at the top take you to those pages. New template opens the editor.

Status

Starter templates

When you have no templates yet, the page offers people who can Change Communications Start with the replies most rescues write? and a button to add them all at once. Each one says what belongs in the paragraph rather than putting words in your mouth, so rewrite them in your own voice before you use them. The button reads Add the (number) standard templates. If your list already holds any of these, the page offers the ones it is missing instead, with Add the (number) new templates. A list made only of your own templates is offered nothing.

Writing a template

New template on the list, or Edit on a template, opens the editor. Press Create template, or Save changes when editing. To add a merge field, click in the subject or the body where it should go, then press the field under Merge fields: click to insert where you were typing. It goes in exactly as it must be spelled. If the subject or body holds a placeholder that nothing fills, the editor says so: Nothing fills the placeholder, and Compose will leave it in the message for somebody to replace, while a workflow sending the template will be refused.

Merge fields

A merge field is a placeholder in double braces. When a template is used, each one is replaced with the real value. “Their” is the person the message is to. When it is to several people, the field holds all of them: “Jane and John”. The animal fields come from the animals chosen in Compose, or the animal the message is about, or every animal an adoption application asks for. For a message to a household, or about a litter, {{people}} and {{animals}} say each of them on a line of its own rather than joining them into one phrase. Put one on a line by itself and it becomes a bullet list, one item a line. Inside a sentence, or in the subject, the lines are joined with a semicolon instead. Your rescue’s email, phone and website come from Email, Phone and Website on Settings → Organization → General profile.
A workflow cannot fill {{org_email}}, {{org_phone}} or {{org_website}}, so a workflow step sending a template that uses one is refused. A workflow that runs on a person has no animal to fill the animal fields from either.
A field with no value on the record, such as an animal with no breed, is left as written rather than blanked, so that a message never goes out reading “Dear ,”. Compose and the reply box then refuse to send until somebody replaces it. Templates written with the older spellings still fill: {{person.first_name}}, {{animal.name}}, {{animal.pet_id}}, {{organization.name}} and the others of that form.

The template page

Pressing a template in the list opens its page. The heading is the template’s key, the short code it is filed under. The page shows:
  • Status, Channel (email) and Updated
  • Subject, and the words of the Body
  • History, every version of the wording
  • Variables, the merge fields it uses

History

Every change to a template’s wording is kept. Each version shows its number, when it was saved and who saved it, any note, and its subject and body in full. The one being used now is marked In use now. The first version is noted “Created.” A new version is recorded only when the subject, the body or the merge fields change. Renaming a template or changing its status does not add one. Put this back on an older version makes its wording the current wording again. It does not erase anything: the wording you replace stays in the history, and the restore is added as a new version noted “Restored version” and its number. It needs Change on Communications.

Deleting a template

Delete removes a template and its history. It asks you to confirm first.
Deleting cannot be undone. A template is refused deletion once any message has been sent from it, or while a workflow step sends it. Archive it instead.