Email notification themes

You can customize email notification themes if you're on the Growth plan or higher.

If you're on the Growth plan or higher, you can customize your email notifications directly from your TalkJS dashboard. You can customize both the appearance and the headers of the email notifications.

Customize an email notification theme

You can edit the appearance of your email notifications directly from your Theme editor.

To customize your email notifications theme, go to the Themes page of your dashboard. In the Email themes section, choose an existing email theme to modify by selecting the Edit beside the theme's name, or select Create new theme at the bottom of the overview of email themes.

You can use HTML and CSS to customize the built-in Email component, or add your own custom components.

In addition to customizing the body of the email, you can also customize the email headers of a theme, from the Headers tab of your email theme editor.

Overview of the email theme editor, with the section 'Headers' selected. An panel with 'Email headers' is open, in which the 'From' and 'Subject' headers can be customized. Below the panel is an arrow to a preview of how the headers would show up in an email.

You can use the following macros in the email notification header:

  • app.name
  • app.id
  • app.locale
  • app.custom.<CUSTOM_FIELD>
  • sender.id
  • sender.name
  • sender.custom.<CUSTOM_FIELD>
  • recipient.id
  • recipient.name
  • recipient.custom.<CUSTOM_FIELD>
  • conversation.id
  • conversation.subject
  • conversation.topicId
  • conversation.custom.<CUSTOM_FIELD>

Replace <CUSTOM_FIELD> with the name of the custom field that you would like to use.

Activate your custom email notification theme

To use your custom email notifications theme, go to the Notifications page on your dashboard. In the Email settings section, make sure that the Enable email toggle is on. From the Email type dropdown menu, select Custom theme. In the overview with email themes, select the custom email theme you'd like to use for email notifications.

Overview of the 'Email settings' section on the Notifications page in the dashboard, with a toggle labelled 'Enable email' highlighted. Under a header 'Email type', from a dropdown menu, the option 'Custom theme' shows. Under the header 'Themes' is a list with email themes, with the option 'default_email' selected, with next to it a green label stating 'Active'.

Once you have selected your custom email theme, the theme is active in your email notifications to users.