Lists / Audiences Management¶
In MailChimp, an audience is your list of contacts. The connector brings every audience into Odoo as a native Mailing List, so you can manage subscribers, settings, segments and merge fields from Odoo while MailChimp keeps doing the sending.
Open your audiences from .
Import Audiences from MailChimp¶
The fastest way to get started is to import your existing audiences.
Go to .
Select your Account(s), choose Lists/Audiences, and click Process.
Each imported audience also appears as a mailing list (tagged MailChimp) in , with its subscriber, bounce, opt-out and blacklist counts.
Note
Importing an audience also pulls its merge fields and segments automatically, so the audience is ready to use right after import.
The Audience Form¶
Open an audience to see its details, sync actions and configuration tabs.
The header shows the key audience details:
Audience Name and Associated Account — which MailChimp account the audience belongs to (useful when you manage several).
Creation Date — when the audience was created in MailChimp.
Subscribe URL Short / Long — Shareable links for users to directly subscribe to this audience.
List Rating — Star rating provided by MailChimp, reflecting the audience’s engagement quality.
Fetch Member Since Last Change — Tracks the last sync time, ensuring Odoo always has updated records.
Contact Status Breakdown¶
The smart buttons at the top of the form summarize the audience by status. Click any of them to open the matching contacts.
Total Contacts — All deliverable members (blacklisted contacts are not counted).
Subscribers — Active members who opted in, the target of your campaigns.
Transactional — Contacts are neither subscribed nor unsubscribed. They don’t count toward marketing campaign sends but are still part of the list.
Unsubscribed Contacts — Displays how many members have opted out of your marketing emails. These contacts remain in the audience but are excluded from future campaigns.
Cleaned Contacts — Represents blocked or non-deliverable email addresses (bounced or permanently failed). MailChimp automatically marks them as cleaned to prevent wasting sends.
Tip
Tracking cleaned and unsubscribed counts in Odoo helps you monitor list health and keep campaign deliverability high.
Synchronizing an Audience¶
The header buttons keep an individual audience aligned with MailChimp:
Export In MailChimp — Create this audience in MailChimp (shown only for audiences created in Odoo that don’t exist in MailChimp yet).
Update In MailChimp — Push updated audience details from Odoo into MailChimp.
Refresh — Pull the latest audience details, settings and statistics from MailChimp.
Fetch Merge Fields — Sync subscriber attributes (First Name, Last Name, address, custom fields…).
Fetch Segments — Pull MailChimp segments and tags into Odoo for targeting.
Fetch Members — Retrieve the audience members (contacts/subscribers) into Odoo.
Note
Fetch Members queues the members in the background. They appear in Odoo as the Process Queue Jobs scheduled action runs (see Scheduled Actions).
Auto Export Contacts to an Audience¶
Instead of pushing contacts one by one, you can have Odoo automatically export any contact that matches a condition into this audience.
On the audience form, enable Auto Export Contact?.
Choose the Contact Type — Customer (
res.partner) or Mailing Contact.Define an Apply Filter condition (for example
Email is set). Only matching records are exported.Use Check Remaining to preview the contacts still waiting to be exported.
The Auto Export Contact to MailChimp List scheduled action then pushes those contacts to MailChimp on a schedule. Use the Scheduled Actions link to adjust the interval.
Tip
Build the filter to match exactly who should receive your emails — for example customers from a specific country, or contacts with a given tag — so only the right people are added to the audience.
Audience Tabs¶
Settings¶
The Settings tab mirrors the MailChimp audience configuration. Changes saved here can be pushed back with Update In MailChimp.
Publicity settings — Whether your campaigns are publicly discoverable, and whether the archive bar is shown in archived emails.
Form settings — Enable double opt-in (a confirmation email on subscribe) and GDPR fields on your signup forms.
Campaign defaults — The default From Name, From Email, Subject and Language applied to campaigns for this audience.
Note
When you select a MailChimp audience on a campaign, Odoo fills the From and Reply-To from these defaults automatically.
New subscriber notifications — Email addresses that get notified when someone subscribes or unsubscribes.
Required Email Footer Content — The permission reminder and the contact/physical address MailChimp requires in every campaign footer by law.
Email Beamer — Every MailChimp audience has its own private email address. Send an email to it from your usual email client and MailChimp saves the message as a draft campaign for that audience, ready to send.
Note
The Email Beamer address is provided by MailChimp. Copy it from MailChimp at and paste it here if needed.
Segments¶
The Segments tab lists the audience’s segments and tags synced from MailChimp (for example Gold, Silver, Distributor). Use Fetch Segments to refresh them. Segments let you target a specific group of subscribers when sending a campaign.
Merge Fields¶
The Merge Fields tab lists every subscriber attribute synced from MailChimp, with its Name, Tag, Type, Required Status and Visible flags. Map each merge field to an Odoo Field so the value is filled automatically when contacts are exported or updated.
Important
Use the tag FNAME for First Name and LNAME for Last Name.
You do not need to map an Odoo field for address-type fields or for the FNAME/LNAME tags — these are filled automatically during export/update.
Statistics¶
The Statistics tab shows audience metrics fetched from MailChimp — total members, subscribed/unsubscribed/cleaned counts, average subscribe and unsubscribe rates, and open and click rates. Click Refresh to update them.
