​

Concepts and Overview

​

How Notification Templates Work

1. Triggers an event subscription configured with a notification template.
2. Renders the template with live data from the event using Handlebars syntax.
3. Adapts the rendered HTML for each channel (email as HTML, Slack as formatted blocks, Teams as adaptive cards, and so on)
4. Sends the notification to configured destinations.

​

Two Template Types

​

System Templates

• Read-only by default (cannot be deleted).
• Can be modified to customize appearance.
• Auto-update if you haven’t customized them.
• Only users with “Edit All” permission can create system templates.

​

User Templates

• Fully editable and deletable.
• Custom formatting for domain-specific events.
• Reusable across multiple event subscriptions.
• Require “Edit All” or “Edit User Notification Template” permission.

​

Template Structure

​

Template Subject (templateSubject)

• Maximum 256 characters.
• Supports Handlebars templating for dynamic content.

[{{publisherName}}] - {{camelCaseToTitle event.entityType}} Updated: {{entity.fullyQualifiedName}}

​

Template Body (templateBody)

• Maximum 10,240 characters.
• Supports HTML formatting and Handlebars templating.
• Automatically adapted by Collate for each channel.

<strong>{{event.userName}}</strong> changed <strong>{{camelCaseToTitle event.entityType}}</strong>:
<a href="{{buildEntityUrl event.entityType entity}}">{{entity.fullyQualifiedName}}</a>

{{#if changes.updates}}
<h3>Updated Fields:</h3>
<ul>
  {{#each changes.updates}}
  <li><strong>{{name}}</strong>: {{oldValue}} → {{newValue}}</li>
  {{/each}}
</ul>
{{/if}}

• Email: Renders as formatted HTML with links.
• Slack: Converts to Slack block format with proper formatting.
• Teams: Converts to Adaptive Cards format.
• Google Chat: Converts to Google Chat message format.
• Webhooks: Sends the raw template data.

​

Next Steps

• New to templates? → Start with Create and Manage Templates
• Want to write templates? → Learn Handlebars Templating Guide