Templates

A template is a single HTML document with {{variable}} tokens that SignatureCat renders per user. Templates live on the Signatures page (Designers, Editors and Admins) and are edited in a code editor with live preview.

For a guided first run, see Create your first template. The variable set has its own page: Template variables.

The editor

The editor at app.signature.cat/signatures/{id} is HTML-first: you edit the signature markup directly, with autocompletion for all {{variable}} tokens. Alongside the code pane you get:

• Preview - live rendering of the resolved signature, in a sandbox. Render as substitutes any real user's Directory record so you can check edge cases (long names, missing phone numbers).
• Insert variable - menu of all person variables, grouped with hints.
• Logo / Banner - the per-kind image galleries; see Banners and logos.
• Wrap in {{del}} / Wrap in {{delete}} - wraps the current selection in conditional tags.
• Set me a test signature - renders against your own Directory record and applies to your own Gmail mailbox only.
• Name and icon - a label, icon and color shown in template lists (never rendered into signatures).

Validation and sanitization

Saving validates the template and rejects:

• unknown tokens (anything that is not a known variable, asset token or conditional tag),
• unbalanced {{del}} / {{delete}} pairs.

The HTML is sanitized on save: scripts, iframes, event handlers (onclick= and friends) and javascript: URLs are stripped. Signatures are static HTML by nature - Gmail would strip active content anyway.

The default template

One template can be marked as Default. Users who are not covered by any assignment or self-service choice fall back to it - and so do users whose assignment was deleted.

Self-service toggle

Each template has a self-service switch controlling whether end users can pick it on the My signature page. Disabling it clears the self-service choices that use it (with a confirmation). Details: Self-service.

Deleting a template

Deleting an unused template just removes it. Deleting a template that is in use shows a cascade dialog first, spelling out exactly what goes with it:

• its group and OU assignments,
• self-service choices made by users,
• queued apply jobs (cancelled).