Terms explained
Plain-language explanations of terms used in the MailDesk documentation. Technical names are in parentheses for administrators and developers. Terms are sorted alphabetically.
Who this is for: everyone. Everyday users need only the first sentence of each entry.
Autopilot (IMAP)
MailDesk's automatic way to choose the best sync method for each IMAP server. You do not set anything. Once a week it asks the server what it supports and puts the account into one of four profiles: A (the most capable servers, cheapest updates), B (supports waiting for new mail), C (basic IMAP) or D (the server's answers are not reliable, so MailDesk is careful). See Advanced: IMAP server profiles (A-D). (Use cases detect_imap_profile.py, sync_imap_folder_smart_pro.py.)
Backfill
The background loading of older mail after you connect a mailbox. The newest mail loads first and older history follows gradually.
Basic
The MailDesk engine and the base plan: unified inbox, one-way sync (server to Odoo), composer and the data model. It has no AI. (Module maildesk_mail_client.) See Plans and included features.
Bootstrap
The first fill of a folder when a mailbox is newly connected.
Bridge (Workflow Bridge)
An optional add-on that connects MailDesk to another Odoo app, so you can link an email to that app's records, for example a CRM lead or a Helpdesk ticket. Every bridge requires Pro. A bridge reads and links; it does not own MailDesk's message data. The Cockpit is a manager add-on built on the Automation bridge, not a bridge itself. Which plan includes which bridge is on Plans and included features.
Bus
Odoo's channel that pushes updates to open browser tabs. After MailDesk has stored a new message, it tells other open tabs and users so they see the change quickly. This is only screen updating. It is not the same as a push notification from your mail provider. (Model ir.websocket.)
Cockpit
A dashboard for managers. It shows numbers about MailDesk activity, such as open conversations, response times and workload, and has AI briefings and SLA tracking. It only reports. It does not change your mail. It is a separate add-on that needs Pro and the Automation bridge. (Module maildesk_mail_client_cockpit.) See Monitor email operations with Cockpit.
delivery_key
The identity of a synced message: the combination of account, provider, folder and uid. MailDesk uses it to recognise the same message again at every sync and to address changes in the outgoing queue. This is why a linked email stays linked when you move it to another folder or change its label.
Ingest queue
A waiting list that turns stored messages into Odoo mail messages, so they work with Odoo features such as Chatter, activities and record links. It retries when something fails. One scheduled job adds messages to the queue and another imports them. (Model maildesk.ingest_queue.)
Lease
A short lock that lets only one worker sync or change an account at a time, so parallel jobs do not collide. (Model maildesk.account_lease.)
Mailbox account
A connected Gmail, Microsoft 365 / Outlook or IMAP mailbox in MailDesk. It holds the sign-in or credential state, sync state, owner and the list of users with access. (Model mailbox.account.) See Give users mailbox access.
Message index
The place where MailDesk stores message details: sender, recipients, subject, date, folder, flags and identity. It does not store bodies or attachment lists; those are in the UI cache. It is the single source of truth (SSOT) for message data and is keyed by delivery_key. (Model maildesk.message_index.)
Near-realtime
How fresh your inbox is. New mail shows up shortly after it reaches your provider, not at the same instant. With Gmail and Microsoft 365 push, the delay is short. With IMAP it depends on the poll interval. See How quickly email synchronizes.
Prefetch (body prefetch)
Loading message bodies into the UI cache before you open them, so a message or folder opens quickly. A queue is fed when a new message is synced and when a folder list is shown. A job that runs once a minute fills the cache within time and load limits. In Basic these hooks do nothing; Pro provides the real implementation. (Model maildesk.message_prefetch_queue.) See How email previews are stored.
Pro
Extends Basic with two-way sync, the AI assistant, the phone-friendly layout, the dark theme, and faster sync and prefetch. All bridges require it. (Module maildesk_mail_client_pro.)
Push subscription
A registration with Gmail (Cloud Pub/Sub and users.watch) or Microsoft 365 (Microsoft Graph /subscriptions) that lets the provider tell MailDesk when new mail arrives, instead of MailDesk waiting for the next scheduled check. Subscriptions expire and renew automatically. The notification only starts the normal sync, so push shortens the delay but does not replace sync. (Model maildesk.push_subscription.)
Silence detection
A safety net. If no push notification arrives for a long time, MailDesk schedules a full resync of the account so that nothing is missed.
SSOT (single source of truth)
A design rule: one place owns each piece of data and everything else reads from it. In MailDesk the message index owns message details. The ingest queue, UI cache, bridges and outgoing update queue use it and do not keep competing copies.
Two-way sync
Pro's ability to send your changes back to the mail provider. When you flag, label, move or delete a message in MailDesk, Pro applies the change on Gmail, Microsoft 365 or IMAP. Changes are combined per message and retried if needed. Basic is one-way only (server to Odoo). (Model maildesk.update_queue and mutation_executor.py per provider.)
UI cache
A short-lived store for message bodies and attachment lists, so MailDesk does not fetch a message from the provider every time you open it. It is cleaned up on a schedule. Prefetch fills it ahead of time. (Model maildesk.ui_cache.)
Update queue
Pro's queue of outgoing changes (flag, label, move, soft delete). It is the engine behind two-way sync. It combines changes per message, locks the work with leases, and retries with waiting times, up to eight attempts, before applying each change at the provider. (Model maildesk.update_queue.)