Templates

What are Templates?

Templates in SuperFCM are reusable message configurations that serve as the foundation for your notifications. They define the structure, content, and appearance of messages across your communications. Each template consists of:

• Name: A descriptive identifier for the template (not visible to subscribers)
• Localized Content: Localized title and message for each language chosen for the template. The app's primary language is pre-selected by default and acts as a required fallback for subscribers whose preferred language isn't available in the template.
• Config: Additional configuration information such as the icon to be used, message priority, time-to-live (TTL), sound, badge, click action, and any other relevant settings.
• Status: The current state of the template (draft, active, archived)

info

During early access we do not yet support:

• Placeholders in templates
• Template-specific analytics

Template Status

Each template in SuperFCM has a lifecycle status that determines how it behaves and where it can be used within the platform. Understanding these statuses is critical for managing your templateation strategy effectively.

Status	Dashboard Visibility	Available for Messages	Editable	Deletable
Active	✅	✅	✅	❌
Draft	✅	❌	✅	✅
Archived	❌ (by default)	❌	❌	✅

Active Templates are fully functional: they can be used in messages and be edited at any time. Changes to active Templates are not reflected in linked (referenced) messages as template content is copied, not linked to messages. However, SuperFCM will detect updates to templates and prompt you to sync the latest template content to a message when editing a message.

Draft templates, while editable, are not usable in messages until activated, making them ideal for building and testing in advance of a campaign.

Archived templates are frozen: they are hidden from the dashboard view and excluded from all messaging workflows. If edits or reuse are required, archived templates must first be restored from archive.

Managing Templates

Creating Templates

To create a template:

1. Go to the Templates section in your dashboard.
2. Click New template.
3. Provide a descriptive name for the template.
4. Add your localized contents.
5. Save the template by clicking Save draft.

info

New Templates are are automatically created as draft and require activation before they can be used.

Activating Templates

To activate a template:

1. Go to the Templates section in your dashboard.
2. Find the template you wish to copy.
3. Click the context menu (three dots) next to it.
4. Select Activate.

Editing Templates

To edit a template:

1. Go to the Templates section in your dashboard.
2. Find the template you wish to edit.
3. Tap it and make the changes in the dialog that opens.
4. Save the changes by clicking Save.

warning

Changes to active templates will not affect any past or future deliveries of messages, as the content is copied into the message when it is created or edited. If you wish for the updated template changes to be reflected in future deliveries of a message, you must edit the message and resync the template.

Copying Templates

To copy a template:

1. Go to the Templates section in your dashboard.
2. Find the template you wish to copy.
3. Click the context menu (three dots) next to it.
4. Select Copy.

This will create a duplicate of the template in draft state. To rename, simply edit the template.

Archiving Templates

When a template is no longer needed but should be preserved for future reference:

1. Go to the Templates section in your dashboard.
2. Find the template you wish to archive.
3. Click the context menu (three dots) next to it.
4. Select Archive.

warning

If you archive a template that’s still linked to a message, the message content remains intact, but the link to the template is broken. Any future deliveries from that message will no longer referenced to the template.

Restoring Templates

To bring back an archived template:

1. Go to the Template section in your dashboard.
2. Find the template you wish to restore (use the dashboard filters to show archived templates).
3. Click the context menu (three dots) next to it.
4. Select Restore.

Restored templates return to draft state and must be activated before use.

info

Restoring a template will not bring back the link to a message that may have existed before archiving the template.

Deleting Templates

To permanently delete a template:

1. Go to the Templates section in your dashboard.
2. Make sure the template’s status is Draft or Archived.
3. Click the context menu next to the template.
4. Choose Delete.
5. Confirm the deletion.

warning

If you delete a template that’s still linked to a message, the message content remains intact, but the link to the template is broken. Any future deliveries from that message will no longer referenced to the template.

Syncing Template Changes with Messages

When you make changes to a template, these changes will not automatically reflect in any existing messages. The content of a template is copied into the message at the time it is created or edited. If you want the updated template to be reflected in future deliveries, you need to manually edit the message and resync the template. This ensures that any new changes in the template, such as updates to text, icons, or settings, are included in the next delivery. This behavior helps to avoid unexpected side effects when editing templates.