Skip to content

Email Templates

SetGet sends transactional emails for key user interactions. The Email Templates page in the Admin Panel lets you customize the content, layout, and branding of each email type to match your organization's voice and style.

Navigate to Admin Panel > Email Templates or go directly to /backoffice/settings/email-templates.

Available templates

SetGet includes the following customizable email templates:

TemplateTriggerDescription
WelcomeNew user registrationSent when a user creates an account
Workspace InvitationMember invited to workspaceContains a link to join the workspace
Password ResetPassword reset requestContains a time-limited reset link
Magic LinkMagic link login requestContains a one-time login code
Notification DigestScheduled digest deliverySummarizes unread notifications

Template structure

Each email template consists of the following editable parts:

PartDescription
Subject lineThe email subject. Supports template variables.
HeaderTop section of the email body, typically containing logo and greeting.
BodyMain content area with the message and call-to-action.
FooterBottom section with unsubscribe links, legal text, or contact info.

All templates use HTML with inline CSS for maximum email client compatibility.

Editing a template

  1. Navigate to Admin Panel > Email Templates.
  2. Select the template you want to edit from the list.
  3. The editor opens with the current template HTML and a live preview panel on the right.
  4. Make your changes in the HTML editor.
  5. Use the Preview tab to see how the email renders.
  6. Click Send Test to send a preview email to your admin address.
  7. Click Save to apply the changes.

TIP

Always send a test email after editing a template. Email clients (Gmail, Outlook, Apple Mail) render HTML differently, and the preview panel may not catch all rendering issues.

Template variables

Template variables are placeholders that SetGet replaces with real values when sending each email. Variables use double-brace syntax: .

Global variables (available in all templates)

VariableDescriptionExample Output
Instance name from General SettingsSetGet
Instance URL from General Settingshttps://setget.example.com
Current year2026
URL of the instance logohttps://setget.example.com/assets/logo.png

Welcome email variables

VariableDescription
Display name of the new user
Email address of the new user
Direct link to the login page

Workspace invitation variables

VariableDescription
Name of the person who sent the invitation
Name of the workspace
URL slug of the workspace
One-click link to accept the invitation
Assigned role (Admin, Member, Guest)
Invitation expiration date

Password reset variables

VariableDescription
Display name of the user
Time-limited password reset link
How long the link remains valid (e.g., "30 minutes")
VariableDescription
Display name of the user
One-time login code
Direct login link with embedded code
Code validity period

Notification digest variables

VariableDescription
Display name of the recipient
Total number of unread notifications
Array of notification objects for iteration
Time window of the digest (e.g., "Last 24 hours")
Link to notification preference settings

HTML editing guidelines

When editing email templates, follow these guidelines for best compatibility:

  1. Use inline CSS. Most email clients strip <style> blocks. Apply styles directly with style="" attributes.
  2. Use table-based layout. Flexbox and CSS Grid are not supported in many email clients (especially Outlook).
  3. Keep images small. Large images slow loading and may be blocked by default in some clients.
  4. Provide alt text. Always include alt attributes on images for accessibility and when images are blocked.
  5. Test across clients. At minimum, test in Gmail (web), Outlook, and Apple Mail.
  6. Avoid JavaScript. Email clients strip all JavaScript. Interactive elements will not work.

WARNING

Incorrectly formatted HTML can cause emails to render as blank or garbled in some clients. Always preview and send a test email after making changes.

Default template example

Here is a simplified version of the default password reset template:

html
<table width="100%" cellpadding="0" cellspacing="0" style="max-width: 600px; margin: 0 auto;">
  <tr>
    <td style="padding: 24px; text-align: center;">
      <img src="{{logo_url}}" alt="{{instance_name}}" style="height: 40px;" />
    </td>
  </tr>
  <tr>
    <td style="padding: 24px;">
      <h2 style="margin: 0 0 16px;">Reset your password</h2>
      <p>Hi {{user_name}},</p>
      <p>
        We received a request to reset your password. Click the button below to choose a new one. This link expires in
        {{expires_in}}.
      </p>
      <p style="text-align: center; margin: 24px 0;">
        <a
          href="{{reset_url}}"
          style="background: #3F76FF; color: #fff; padding: 12px 24px;
                  text-decoration: none; border-radius: 6px;
                  display: inline-block;"
        >
          Reset Password
        </a>
      </p>
      <p>If you did not request a password reset, you can safely ignore this email.</p>
    </td>
  </tr>
  <tr>
    <td
      style="padding: 16px 24px; font-size: 12px; color: #888;
               text-align: center;"
    >
      &copy; {{current_year}} {{instance_name}}
    </td>
  </tr>
</table>

Reset to default

If a customized template causes issues or you want to start over:

  1. Open the template in the editor.
  2. Click Reset to Default at the bottom of the editor.
  3. Confirm the action in the dialog.
  4. The template reverts to SetGet's built-in default.

WARNING

Resetting a template is irreversible. Your custom content will be lost. Consider copying your current template HTML to a text file before resetting.

Template best practices

PracticeReason
Keep emails conciseUsers scan emails quickly; get to the CTA fast
Use a single clear call-to-actionMultiple CTAs reduce click-through rates
Match your brand colorsConsistent branding builds trust
Include an unsubscribe link in digestsRequired by most email regulations (CAN-SPAM, GDPR)
Test on mobileOver 50% of emails are opened on mobile devices