pagopa-email-templates

April 23, 2026 · View on GitHub

This repo contains the mail templates used by pagoPA, created using MJML markup language.

How to apply changes

To edit them, you can choose among these following options:

To generate the HTML output you need to install these CLI tools:

  1. MJML package:
$ npm install --g mjml
  1. Handlebars CLI to render handlebars templates (via npx, no global install needed)

For the specific commands, take in consideration the local README files:

  1. Receipt · Success
  2. Receipt · KO

How to deploy changes

All the mail are sent through pagopa-notifications-service, it uses the hbs templates file to generate all the different variants. All you need to do is to:

PDF Receipt

If you're looking for the relative PDF receipt, please refer to the pagopa-template-receipt-pdf

Compatibility

Templates are compatible with the following clients:

  • Apple Mail 13+ (dark mode included)
  • Gmail Web app
  • OL Office 365 (dark mode included, partially supported on Windows)
  • Outlook 2013, 2016, 2019, 2021 (dark mode included, partially supported on Windows)
  • Windows 10 Mail (dark mode partially supported)
  • Windows 11 Mail
  • Gmail App (Android 6+, dark mode partially supported)
  • Gmail App (iOS 13.1+, dark mode partially supported)
  • iPad (iOS 13.1+)
  • iPhone (iOS 13.1+)
  • AOL Mail
  • Outlook.com Mail (dark mode partially supported)
  • Yahoo! Mail