Skip to main content

Email templates in self-hosted Ory Kratos


In self-hosted Ory Kratos instances, you can add custom templates from http://, file://, and base64:// URIs. The plaintext and html fields are mandatory when defining the body key. All other keys are optional. If the system can't use the custom templates, it falls back to the built-in templates or to the template_override_path (if specified).

template_override_path: /conf/courier-template
# ...
html: https://some-remote-resource/gotmpl
plaintext: base64://SGV5IHlvdSBkZWNvZGVkIG1lIDop
# optionally, define the subject
subject: file://some-file/subject.gotmpl

When self-hosting Ory Kratos, the system expects the templates at these paths:

  • <kratos-root>/<template-root>/recovery/valid
  • <kratos-root>/<template-root>/recovery/invalid
  • <kratos-root>/<template-root>/verification/valid
  • <kratos-root>/<template-root>/verification/invalid

Read this document to learn more about the email courier and the specifics of using templates in self-hosted Ory Kratos instances.

Translated templates (I18n)

To create internationalized templates, you can either use in-line template definitions, as described here, or as in this example, use separate template files. The following example defines the message body for recovery emails. It assumes that there is a lang attribute defined in the identity traits that contains the preferred language of the user.

{{- if eq .Identity.traits.language "de" -}}
{{ template "" . }}
{{- else -}}
{{ template "email.body.en.gotmpl" . }}
{{- end -}}

{{ .RecoveryCode }}
Hallo {{ upper .Identity.traits.firstName }},

Um Ihr Konto wiederherzustellen, geben Sie bitte den folgenden Code ein:
Hello {{ upper .Identity.traits.firstName }},

to recover your account, please enter the following code:

The i18n template is nested in the root email.body.gotmpl template. The sub-templates must conform to the email.body* pattern. The identity of the user is available in all templates.