Help Center/Admin Operations/How to use the Templates screen (Notifications)
Admin Operations•Last updated: 2026-10-20•3 min read

How to use the Templates screen (Notifications)

Wording overrides per notification kind. An active template replaces the built-in wording for that kind.

Have questions or need step-by-step guidance on this topic?

Ask AI Copilot

Step-by-Step Procedure

1

Open the page

Sign in as an administrator and use Admin sidebar → Notifications → Templates, or go to /admin/notifications/templates. The heading reads "Notification Templates".

2

Know where the data comes from

This page reads i8_notification_templates. Columns: Kind, Title template, Body template, Variables allowed, Status, Updated.

3

Create a template

New Record: choose the "Notification kind", write the "Title template" and "Body template" using only the variables the kind allows (listed in the Variables allowed column, written {{name}}), optionally a link, and save.

4

Edit or retire

Pencil edits (the kind is fixed); the trash icon retires the template so the built-in wording returns.

5

Use the shared controls

Use the shared controls: the search box ("Search records, hashes, DIDs...") filters rows by any text; "Status:" offers ALL, ACTIVE, RETIRED; "Page Size:" sets 10, 15, 25 or 50 rows; Refresh reloads; Export saves the rows currently loaded as a JSON file; New Record opens the form described above. The line "Data:" under the heading names the real source.

Expected Operational Outcome

Notifications of that kind use your wording from then on.

Troubleshooting & Failure Modes

Symptom: "Variable(s) not available for ..."
Likely Cause: The template uses a placeholder the kind does not provide.
Resolution: Use only the variables listed for the kind.
Symptom: "A template for ... already exists"
Likely Cause: One template per kind.
Resolution: Edit the existing one.
Symptom: Error "Failed to load notifications/templates: HTTP 401" or "HTTP 403"
Likely Cause: The session is not signed in or does not hold an administrative role.
Resolution: Sign in again with an administrator account and click Refresh.

Was this guide helpful?

Help us refine our platform documentation