Skip to main content
Odoo Community Association

Email Brand

Beta License: AGPL-3 OCA/brand Translate me on Weblate Try me on Runboat

This module enhances Odoo’s email communication with branding capabilities.

Key Features:

  • Comprehensive Email Branding: Automatically applies branding to outgoing emails. This includes:

    • Displaying the correct brand logo, derived from the linked partner’s image.

    • Setting the sender’s company details (website, address, phone number) according to the selected brand’s information.

  • Website Contextualization: Dynamically adjusts the base URL for links within emails to reflect the website associated with a selected brand.

  • Brand Selection in Email compose wizard: Extends the standard “Compose Email” wizard with a ‘Brand’ selection field. This allows users to explicitly apply a brand to outgoing emails, particularly useful when the originating record isn’t directly linked to a brand.

  • Dynamic Logo Delivery: Includes a custom controller to serve the appropriate brand logo in emails based on the selected brand context.

Table of contents

Use Cases / Context

In summary:

The module prioritizes automatic branding based on the originating record. If no brand is associated with the record, or if you need to override it, you can manually select a brand in the “Compose Email” wizard. Ensure your brands are correctly configured with linked partners and logos for the branding to appear in your outgoing emails.

Usage

1. Defining Brands:

  • Navigate to Contacts > Brands.

  • Create new brand records. For each brand, you can:

    • Partner: Link the brand to an existing partner (company). The logo displayed in emails will be derived from the image of this partner. Ensure the partner has a logo uploaded (visible in the contact form).

    • Website: Optionally specify a website URL associated with the brand. This URL may be used for links in emails.

2. Automatic Email Branding (Based on Originating Record):

  • When sending emails from records that have a brand_id field populated (e.g., Sales Orders, Invoices, or other relevant models), the module will automatically attempt to use the branding associated with that record’s brand.

  • The email will display the logo of the linked brand, and any company details (website, address, phone number) in the email footer should correspond to the brand’s partner information.

3. Manual Brand Selection (Using the Compose Email Wizard):

  • When composing a new email (e.g., via the “Send message” button in the chatter or through other email actions), a Brand field will be available in the “Compose Email” wizard. ( The brand field is only available in the full view of the compose wizard. )

  • Usefull if the originating record does not have a brand_id set, or if you want to use a different brand for this specific email:

    1. Open the “Compose Email” wizard.

    2. In the wizard form, select the desired brand from the Brand dropdown field.

    3. Compose your email content as usual.

    4. Click Send.

  • The email sent will then use the logo and company details associated with the brand you selected in the wizard.

4. Website Links in Emails:

  • If a website is defined for the selected brand, the module may use this website URL for any relevant links included in the email.

Known issues / Roadmap

  • If the brand module gets implemented more broadly this module could need extension to work properly, because not all odoo modules use the same mail templates

  • Color the buttons & other elements in the email according to brand style.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

Credits

Authors

  • Gert Pellin / Snakebyte Development

  • bosd

Contributors

Other credits

Maintainers

This module is maintained by the OCA.

Odoo Community Association

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

Current maintainers:

switch87 bosd

This module is part of the OCA/brand project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

Metadata

Release files for odoo-addon-mail-brand 18.0.1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for odoo-addon-mail-brand 18.0.1.0.2
File Interpreter ABI Platform Actions
odoo_addon_mail_brand-18.0.1.0.2-py3-none-any.whl Python 3 none any Details for odoo_addon_mail_brand-18.0.1.0.2-py3-none-any.whl

Release files / odoo_addon_mail_brand-18.0.1.0.2-py3-none-any.whl

Download URL odoo_addon_mail_brand-18.0.1.0.2-py3-none-any.whl
Size 54.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
16e2f1c30e906e9bb6567881aedd4bfc47d5b33ddeea5a959aab4888030d0145
BLAKE2b-256 checksum
How to use checksums
5e344c51aeb9d454b681b6c1b02cc6bc1264df6e26e6440230cc354d0e48df82
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.4

Security for odoo-addon-mail-brand 18.0.1.0.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page