Upgrading to DefectDojo Version 2.58.x

Notification .tpl templates relocated#

The notification domain has been consolidated under a new dojo/notifications/ package, and the 62 channel .tpl templates that drive alert, mail, MS Teams, Slack, and webhook notifications have moved on disk. The Django template lookup name (e.g. notifications/mail/scan_added.tpl) is unchanged, so most customizations keep working without any edits — but operators who override .tpl files by mounting them into the source tree need to update their paths.

What moved#

The channel templates under alert/, mail/, msteams/, slack/, webhooks/, and webhooks_summary/ have been relocated:

For example, dojo/templates/notifications/mail/scan_added.tpl now lives at dojo/notifications/templates/notifications/mail/scan_added.tpl. A new TEMPLATES["DIRS"] entry pointing at dojo/notifications/templates/ is registered automatically, so the lookup path used by render_to_string() (e.g. notifications/slack/sla_breach.tpl) resolves exactly as before.

Required actions#

• Customizing .tpl files via your own templates directory (recommended pattern): No action required. Overrides resolved by lookup name continue to take precedence.
• Customizing .tpl files via a Docker volume mount or in-tree patch at the old dojo/templates/notifications/... path: Update the mount/patch target to the new dojo/notifications/templates/notifications/... path, or move your override into a project-level templates directory keyed by the lookup name.
• No customizations: No action required.

For more information, check the Release Notes.