# Create message templates

**URL:** https://heroiclabs.com/docs/satori/concepts/player-messaging/create-message-templates/
**Summary:** Define the content, format, and personalisation of messages that Satori sends to players.
**Keywords:** message template, notification template, personalised messages, message content
**Categories:** satori, player-messaging

---


# Create message templates

A message template defines the structure of the content players receive. Define it once and Satori sends from it automatically on every trigger. A recurring tournament reminder, for example, needs one template regardless of how many times the event runs.

## Create a template

In the **Messages** section of the Console, you can view all existing templates. To create a new one, click **Create template** button to open the wizard. The following table describes the available fields to customize your template.

| Field | Required | Description | Example |
|---|---|---|---|
| Name | Yes | A unique identifier for the template | Winter Tournament 2025 |
| Category Labels | No | Labels defined in Taxonomy and used throughout the Console. You can select multiple labels. | tournament |
| Title | Yes | The headline shown in the player's inbox or notification | Limited-Time Winter Tournament! |
| Image URL | No | URL of a banner or promotional image to include | `https://your-cdn.com/winter.png` |
| Content Type | Yes | Format of the message body: Plain Text, HTML, or JSON | Plain Text |
| Content | Yes | The main body of the message | Join today and win exclusive rewards! |
| JSON Metadata | No | Structured data for client-side logic, deep linking, or personalisation | `{"rewardId": "gold_pack_01"}` |

### Content types

- **Plain Text**: Write any message. No formatting.
- **HTML**: Format text, add links and images. The dashboard provides an editor.
- **JSON**: Structured content validated automatically by the editor.

## Rich messages

Templates with an image URL and HTML or JSON content render with a fullscreen preview when opened from the identity inbox in the Console. Use rich messages when the content benefits from a larger view, such as promotional banners or structured reward summaries.

## Add translations for multiple languages

The content you enter when creating a template becomes the default. To add translations, select **Add Translation** in the template details screen.

Satori automatically uses the correct translation based on the player's language property. If no translation exists for a player's language, the default content is used. Translations apply to in-game inbox messages and push notifications sent through integrations.

{{< screenshot src="images/pages/satori/concepts/messages/messages_multilanguage.png" alt="Template details screen showing the Add Translation option" >}}

## Personalise with player properties

Templates support property placeholders in all content types. Satori replaces each placeholder with the player's actual property value at send time.

```text
{{ propertiesCustom.name }}, congrats!
You just completed level {{ propertiesComputed.levelCompletedCount }}! Claim your reward now.
We sent a discount code to {{ properties.email }} for your next purchase.
```

All [property types](../../segmentation/understand-player-properties/) are supported: default, computed, and custom.

## Test a template

To test a template before sending it live, open the template details screen and select **Test**. Provide a player identity ID and select an integration if you want to test push delivery. The message is sent immediately to that identity only.

{{< screenshot src="images/pages/satori/concepts/messages/messages_test_template.gif" alt="Testing a message template" width="65%" >}}

<!-- IMAGE: Screenshot of the Send Message dialog showing Identity ID field, Template dropdown, Integrations selector, Persist in Identity Inbox checkbox, and OneSignal Channels field -->

<!--
CONVERSION NOTES
- Images (1): after "Test a template" section — screenshot of Send Message dialog
- featured_image: needs filename once image is exported
- Author note at top of source doc skipped
- Image URL example in table kept as inline code — not a live hyperlink
-->