Email templater

Easy and intuitive to use The tool is designed to be simple and user-friendly, allowing you to quickly create and customize your email templates.

Accessing the email templater You can access the editor from Settings > General settings > Email template editor [Beta].

Template scopes

The platform manages two families of email templates, identified by their scope:

ScopeAudienceConfiguration level
STOREFRONTCustomer-facing emails (order confirmations, account emails, quote notifications, etc.)Per store and per locale
BACK_OFFICEEmails sent to Back Office users (export downloads, job failure notifications, logistic order confirmations, supplier quote updates)Global to the platform

Storefront templates

The 18 storefront templates are contextualized by store and locale: each template can have a different content and enabled/disabled state per store and per locale. See Email Localization for how the locale of an outgoing email is resolved.

Back Office templates

The 7 Back Office templates are available in the same editor:

Template IDPurpose
product-export-downloadDownload link for a product export
offer-export-downloadDownload link for an offer export
order-export-successNotification that an order export completed
pay-export-downloadDownload link for a payment export
new_job_execution_failedNotification that a job execution failed
logistic-order-confirmationConfirmation of a logistic order
update-supplier-quoteNotification that a supplier quote was updated
⚠️

Warning: Back Office templates are global to the platform. The template detail page hides the store and locale selectors, and both the enabled/disabled state and the content edits apply globally — there is no per-store or per-locale segmentation for these templates.

Default templates

Each store ships with default email templates built into the platform. When no custom template has been configured for an email, the default template is used as a fallback, so critical emails (order confirmations, account emails, etc.) are always sent.

📘

Note: Default templates are being rolled out progressively. Contact DJUST to confirm availability on your environment.

flowchart LR
  %% Styles (Readme)
  classDef create   fill:#e8f1ff,stroke:#2f6feb,stroke-width:2px,color:#0b3d91;
  classDef read     fill:#ede9fe,stroke:#7c3aed,stroke-width:2px,color:#1e1b4b;
  classDef update   fill:#e0f7fa,stroke:#06b6d4,stroke-width:2px,color:#0c4a6e;
  classDef add      fill:#ecfdf5,stroke:#10b981,stroke-width:2px,color:#064e3b;
  classDef remove   fill:#fee2e2,stroke:#ef4444,stroke-width:2px,color:#7f1d1d;
  classDef decision fill:#fff4e5,stroke:#f59e0b,stroke-width:2px,color:#7a3e00;
  classDef place    fill:#dcfce7,stroke:#16a34a,stroke-width:2px,color:#14532d;
  classDef sys      fill:#f2f4f7,stroke:#475569,stroke-width:2px,color:#111827;
  classDef stop     fill:#fee2e2,stroke:#ef4444,stroke-width:2px,color:#7f1d1d;

  A[📧 Email event<br>triggered] --> B{Template<br>enabled}
  B -->|No| X[🚫 No email sent]
  B -->|Yes| C{Custom template<br>configured}
  C -->|Yes| D[🧾 Use custom<br>template]
  C -->|No| E[📘 Use default<br>template]
  D --> F[✅ Email sent]
  E --> F

  class A sys
  class B decision
  class C decision
  class D read
  class E read
  class F place
  class X stop
  style A rx:8,ry:8
  style D rx:8,ry:8
  style E rx:8,ry:8
  style F rx:8,ry:8
  style X rx:8,ry:8

Enabling and disabling templates

Each template can be enabled or disabled directly from the Back Office:

  • Storefront templates — per template, per store, and per locale.
  • Back Office templates — per template, globally.

A disabled template stops the corresponding email from being sent.

Email template categories All templates start as blank drafts. They are organized into four categories:

  • All
  • Account
  • Order
  • Quote

Page structure The email template editor is divided into five main sections:

  1. Settings
    • Navigate between different emails
  2. Subject
    • Enter the subject line of the email
  3. Additional recipients
    • Manage CC and BCC recipients
  4. Variables
    • Insert any of the available variables into the email you are creating
  5. Template editor
    • On the left: the main preview area
    • On the right: design options (heading, button, image, color, size, typography, etc.)
    • Works with a drag-and-drop interface for easy customization



Managing templates via the API

Email templates can also be managed through the Admin API:

EndpointoperationIdDescription
GET /v1/mail-templatesgetMailTemplatesList the mail templates
GET /v1/mail-templates/{templateId}getMailTemplateGet a mail template
GET /v1/mail-templates/{templateId}/contentgetMailContentGet the content of a mail template
PATCH /v1/mail-templates/{templateId}/contentupdateMailTemplateEnable or disable a mail template
POST /v1/mail-templates/{templateId}/contentcreateOrUpdateMailContentCreate or update the content of a mail template

The template context returned by these endpoints carries a scope field (STOREFRONT or BACK_OFFICE).

{
  "id": "product-export-download",
  "name": "Product export download",
  "enabled": true,
  "scope": "BACK_OFFICE",
  "locales": [
    "en_US",
    "fr_FR"
  ],
  "mailTemplates": [
    {
      "locale": "en_US",
      "templateId": "product-export-download"
    }
  ]
}

Tip: The scope field is additive and backward compatible: existing integrations that ignore it keep working, and templates without a scope behave as storefront templates.


Did this page help you?