OdooWiki OCA HUB

Mail Notification Custom Subject

mail_notification_custom_subject folder_open OCA/mail open_in_new
Social Network License: AGPL-3

This module allows you to specify templates to override the subject on the notification emails sent by Odoo

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Lets you define templates that change the subject line of notification emails sent by Odoo, based on the record type and message subtype.

This module adds a new configuration screen where you create subject replacement templates. Each template is linked to a document type (for example sales orders or projects) and to one or more message subtypes, so it only applies to the right kind of notification.

For every template you choose how the subject is changed: - Replace: the whole subject is replaced by your template. - Append Before / Append After: your text is added at the start or end of the existing subject. - Partial Replacement: a specific piece of text inside the subject is swapped for your text.

You can use placeholders in both the text to replace and the new subject, so values from the record (such as the company name) are filled in automatically. The new subject is translated, so each user can see it in their own language.

When Odoo posts a message on a record, it looks for templates matching that document type and message subtype and applies them to the subject before the notification email is sent. If a template fails, the error is logged and the original subject is kept.

Only administrators can create, edit or delete templates; other users can view them. The screen is available under the Email section of Odoo's settings area.

Depends on

mail

Menus it adds

menu_mail_notification_custom_subject
Models and fields (2)
  • mail.thread · extends an existing model
  • mail.message.custom.subject · new modelname (Template Name), model_id, position, subtype_ids (Applied Subtypes), subject_template, subject_to_replace

Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 8 confirmed, 1 with no information of 9 versions.

terminal Installation and usage

OCA documentation · Odoo 19.0

Configuration

Source · Odoo 19.0
  • Activate access to Technical Features (debug mode).
  • Go to Settings \> Technical \> Email \> Subject Replacement Templates
  • Create a new template. > - The field Model specifies the model to which the subject > template should apply in the notification emails sent by Odoo. > - The field Subject Template accepts > expressions. > - The field Subject to replace accepts > expressions > - The field Replace specifies if the template should replace > existing content or append to it. > - The field Partial Replacement specifies if the template should > parcial replace existing content.

Usage

Source · Odoo 19.0

To use this module, you need to:

  • Open the chatter in Odoo (e.g. Open an Invoice).
  • Send a message.
  • Observe the rendered Subject template.

No verified information in OCA: Installation.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.