Skip to content

Communication templates

This guide explains the two template-related areas exposed in the organization UI:

  • Communication Templates - reusable communication template records.
  • Configuration > Templates - organization-level template identifiers that are not configured inside a specific service tab.

Prerequisites

  • you are signed in with site administrator permissions
  • you can access the organization settings area
  • you know which template kind or identifier you need to manage
  • communication template management is enabled for the tenant

Open communication templates

  1. Open Organization from the settings icon in the top-right toolbar.
  2. Select Communication Templates in the left sidebar.

The template list includes a search field, filter action, add-template action, pagination, and columns for:

  • identifier
  • type
  • owner
  • update

Communication Templates section showing template search, filter, add action, and list columns


Filter templates

The filter action opens All filters, where you can filter templates by status:

  • Drafts
  • Sent
  • Pendings
  • Enabled
  • Disabled
  • Rejected

Communication template filters modal showing Drafts, Sent, Pendings, Enabled, Disabled, and Rejected options


Template states

Template availability depends on its state.

The lifecycle includes distinct phases: Draft, Submitted (often shown as Sent), Pending, Enabled, Disabled, and Rejected. Use Submitted/Sent for templates already sent for approval processing, and Pending for templates waiting in the review step.

  • Drafts - the template is being prepared and is not available for use.
  • Sent - the template was submitted and sent for approval processing.
  • Pendings - the template is waiting for review or approval.
  • Enabled - the template was approved and is available for use.
  • Disabled - the template was approved in the past but was later deactivated.
  • Rejected - the template did not pass approval and cannot be used until it is revised.

The columns and available row actions can vary by state.

Create

Submit for approval

Automatic validation

Approved

Approved

Deactivate

Reactivate

Rejected

Rejected

Rejected

Rejected

Convert to Draft

Draft

Submitted

Pending

Enabled

Disabled

Rejected

Note: The UI displays the Submitted state as Sent.


Add a communication template

  1. Open Communication Templates.
  2. Select the add-template action.
  3. In New template, use the Details tab to choose the Template kind and enter the required Template identifier.
  4. Add the Template contents.
  5. Add variables if the template needs reusable placeholders.
  6. Use Preview to review the template output when needed.
  7. Select Save.

New communication template form showing Details and Preview tabs, template kind, identifier, contents, variables, and save action

Template kinds

KindInternal identifierUse
Signature RequestEviSign:Email:SignatureRequestSent to EviSign signers requesting a signature.
Signature ReminderEviSign:Email:SignatureReminderSent as a follow-up reminder to signers.
Final NotificationEviSign:Email:FinalNotificationSent at the end of an EviSign process with evidence access details.
Progress NotificationEviSign:Email:ProgressNotificationSent when an EviSign changes status (signed, rejected, or expired). Supports Liquid conditional logic.
Notification TemplateEviNotice:Email:NotificationCustomizes EviNotice notification emails.

Template identifier

The identifier is unique per site and is used to reference the template from the API. No two templates on the same site can share the same identifier.

  • Maximum 100 characters.
  • Allowed characters: letters, digits, colon (:), dot (.), and dash (-).

Template content

Template content is HTML and can include Liquid template language for conditional or dynamic output. See Liquid language below.

Variables

Template content can include two types of variables:

  • Environment variables — provided by the platform from the evidence data. See the Environment variables reference below.
  • User variables — declared by the administrator during template creation. User variables can only be added while the template is in Draft state.

To add a user variable:

  1. In the Details tab, open the variables table.
  2. Add a row and enter a name, a default value (used during preview), and whether the variable is required in each API call.
  3. Reference the variable in the template content using the {{variables.VariableName}} prefix syntax — for example, {{variables.PostalCode}}.

Constraints:

  • Maximum 30 user variables per template.
  • Variable names: alphanumeric only, maximum 30 characters.
  • Default values: maximum 500 characters.

User variables can be deleted while the template is still in Draft state.


Request approval and validation

After saving a template, use the preview flow to confirm that the output is correct before requesting approval.

  1. Open the saved draft template.
  2. Select Preview.
  3. Review the mandatory system variables and any user variables.
  4. Enter sample values where the preview flow allows it.
  5. Generate the preview and review the rendered output.
  6. Select Request approval when the template is ready.

Template approval typically includes:

  • Automatic validation to check that the content is structurally valid and uses the required variables correctly.
  • Manual validation to review whether the content is appropriate for the selected template kind.

If the template passes validation, it can move to the enabled state and become available for use.


State actions and available columns

The columns and row actions shown in the template list vary by the active state tab.

StateColumnsAvailable actions
DraftType, Identifier, Last modificationEdit, Delete
PendingType, Identifier, Approval request dateView (read-only)
EnabledType, Identifier, Activation dateView (read-only), Deactivate
DisabledType, Identifier, Deactivation dateView (read-only), Activate, Delete (after 60 days)
RejectedType, Identifier, Rejection dateView (read-only), Convert to Draft, Delete (after 60 days)

Activate, deactivate, and delete templates

Template lifecycle actions depend on the current state:

  • Enabled templates can be deactivated when they should no longer be available for use.
  • Disabled templates can be reactivated if they should become available again.
  • Draft templates can be deleted at any time.
  • Disabled templates can only be deleted after they have been deactivated for at least 60 days.
  • Rejected templates can be converted back to Draft to revise the content and resubmit for approval.
  • Rejected templates can also be deleted after the rejection has passed the 60-day grace period.

Use the row actions exposed in the current state tab to perform the lifecycle action supported by that state.


Environment variables

Environment variables are populated by the platform from the evidence or service data. Reference them in template content using {{VariableName}} syntax.

VariableDescription
{{Subject}}EviSign subject
{{Issuer}}Issuer name
{{PartyName}}Name of the signer, reviewer, or interested party
{{PartyEmail}}Participant email address
{{PartyDisplayName}}Full name of the recipient
{{PartyRole}}Role of the recipient (signer, reviewer, or interested party)
{{Recipient}}Name of the notification recipient
{{RecipientEmail}}Email of the notification recipient
{{SupportEmail}}Platform support team email address
{{ServiceName}}Service name as configured on the platform
{{ServiceLegalName}}Legal company name of the service
{{ServiceLegalId}}Service legal identifier
{{ServiceUrl}}Service website
{{ServiceLogoUrl}}Link to the platform logo
{{ServiceLogo}}Platform logo as base64 for inline <img> use
{{SupportUrl}}Support page URL
{{GDPRUrl}}GDPR policy page URL
{{LegalTermsUrl}}Legal terms URL
{{DeliveryUrl}}URL to access the signature or notification process
{{EvidenceUrl}}URL to access the documents generated during signing
{{UnsubscribeUrl}}URL for the unsubscribe process
{{CbUrl}}URL that records when a notification is opened
{{InfoText}}Text reported by the web service
{{ReminderNumber}}Signature request retry number
{{SubmittedOn}}Date of issue
{{OwnerFullName}}Full name of the issuing user
{{OwnerName}}Name of the issuing user
{{OwnerEmail}}Email address of the issuing user
{{IssuerLogoHtml}}HTML <img> tag with the embedded issuer logo
{{AdditionalInfo}}Text indicating whether the email is a reminder
{{ActionName}}Whether the email is a Signature or a Validation email
{{ActionText}}Button label for accessing the notification content
{{Outcome}}Final result of the evidence (signed, rejected, expired)
{{State}}Current status of the evidence
{{Language}}Notification language
{{CopyrightDate}}Platform copyright date
{{CertificationLevel}}Certification level of the notification
{{ServiceLegalTextTemplate}}Legal text accompanying the email

Not all variables are available for every template kind. The Preview tab shows which variables are mandatory for the selected kind.


Liquid language

Template content can include Liquid template language for conditional or dynamic output. This is especially useful in Progress templates, where a single template can handle signed, rejected, and expired statuses using if blocks.

Reference: Shopify Liquid · DotLiquid


Best practices for template approval

Templates go through automatic and manual validation before they can be enabled. Following these guidelines reduces rejection risk.

Image limits

  • Convert images to base64 inline to reduce rendering overhead.
  • Maximum 3 images larger than 48×48 px per template.
  • Maximum 8 images at or smaller than 48×48 px (typically social icons).
  • Total file size of images and content must not exceed 1 MB.

Restricted components

The following cannot be used in templates, as mail clients may block emails that contain them:

  • JavaScript
  • Animated GIFs (whenever possible, avoid)
  • <iframe>
  • Embedded audio
  • Embedded video
  • Forms
  • CSS links (external stylesheets)

Suspicious links should also not be included.

Content requirements by template kind

EviSign — Signature Request and Signature Reminder

  • Text must refer to the issuer's request for a signature.
  • Must include a clearly visible button linking to the signature process.
  • Must also include the signature process access link as plain text (not only as a button).
  • Must include the mandatory variables for this kind.

EviSign — Final Notification

  • Text must clearly indicate it is a final notification of the signing process.
  • Must include steps for accessing the generated evidence.
  • Must include a link to the generated evidence.
  • Must include the mandatory variables for this kind.

EviSign — Progress Notification

  • Uses Liquid code to handle the three possible statuses in a single template:
    • Rejected: text must clearly state that a signatory rejected the document.
    • Signed: text must clearly state that a signatory accepted the document.
    • Expired: text must clearly state that the signature process expired without being completed.
  • Must include the mandatory variables for each status.

EviNotice — Notification Template

  • Text must state that a notification has been sent and provide a button or link to access it.
  • Must include the mandatory variables for this kind.

Templates must include a GDPR notice that identifies the data controller role. The notice should reference the service's GDPR policy URL using the {{GDPRUrl}} variable rather than hardcoding a link.

Anti-spam

Use clear, plain language. Avoid sensationalist wording, misleading subject-like phrases, or anything that could be interpreted as phishing. Mail clients flag templates that use deceptive patterns.


Configuration templates

The Configuration > Templates entry is separate from Communication Templates. It contains organization-level template identifiers that are not configured inside a specific service tab.

In the current UI, this section includes PIN signature templates, such as the email signature verification code template identifier for EviSign and EviNotice.

Service-specific template identifiers can also appear in service configuration tabs, such as EviNotice and EviSign custom template identifiers.


What to check

Before changing templates, confirm:

  • whether you need a reusable communication template record or a configuration template identifier
  • the template kind matches the intended communication purpose
  • the template identifier is unique and matches any integration references
  • the template content uses supported variables
  • preview output has been reviewed before requesting approval or enabling the template
  • the current template state allows the action you want to perform

Expected result

Administrators can search, filter, create, submit, activate, deactivate, and maintain reusable communication templates, and can review organization-level template identifiers from Configuration > Templates.


Sample templates

Download a sample template to use as a starting point. Each file is a working HTML template that includes the mandatory system variables for its kind and a GDPR notice section.

LanguageEviSign Signature RequestEviSign Signature ReminderEviSign Final NotificationEviSign Progress NotificationEviNotice Notification
EnglishHTMLHTMLHTMLHTMLHTML
SpanishHTMLHTMLHTMLHTMLHTML
CatalanHTMLHTMLHTMLHTMLHTML
GermanHTMLHTMLHTMLHTMLHTML
FrenchHTMLHTMLHTMLHTMLHTML
ItalianHTMLHTMLHTMLHTMLHTML
PortugueseHTMLHTMLHTMLHTMLHTML
RomanianHTMLHTMLHTMLHTMLHTML