OdooWiki OCA HUB

Announcement

announcement folder_open OCA/server-ux open_in_new
Server UX License: AGPL-3

This module adds popup announcements in the backend for targeted internal users. Those announcements can contain rich format and a user read log is kept for everyone.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Create internal announcements that pop up for targeted Odoo users, with rich content, attachments, tags and a read log showing who has read them.

This module lets you publish internal announcements inside Odoo. Managers create an announcement with a title, rich-text content, optional attachments and tags, then choose who should see it: either specific users or one or more user groups. A "General Announcement" option automatically targets all internal users.

Announcements appear in a megaphone icon in the top systray bar, with a counter of unread items. When a user logs in, unread announcements are shown as popups; the user clicks "Mark as read" to dismiss them. The list refreshes automatically every minute.

You can schedule announcements with an "Announce at" date and a "Valid up to" expiry date, so they only appear during that period. Announcements can be listed, shown as cards, or displayed in a calendar coloured by their first tag.

A read counter on each announcement shows how many of the targeted users have read it. A button opens a "Read Logs" screen listing both readers (with date) and non-readers, grouped by read state.

Tags can be organised in a parent/child hierarchy and are managed from a technical menu. Access is controlled by an "Announcement Manager" group; regular users can only see announcements addressed to them and their own read logs.

Depends on

mail

Menus it adds

menu_announcement_tag_managementmenu_announcement_management
Models and fields (6)
  • ir.http · extends an existing model
  • res.users · extends an existing modelread_announcement_ids, unread_announcement_ids
  • announcement · new modelname (Title), color, active, content, in_date, tag_ids (Tags), sequence, attachment_ids (Attachments), user_group_ids, allowed_user_ids, announcement_type, notification_date, specific_user_ids, allowed_users_count, announcement_log_ids, notification_end_date, is_general_announcement (General Announcement), notification_start_date, read_announcement_count, notification_expiry_date
  • announcement.log · new modelannouncement_id
  • announcement.tag · new modelname, color, parent_id (Parent Tag), company_id (Company)
  • read.announcement.wizard · new modeldate (Read Date), user_id, read_state, announcement_id

Text generated by AI (DeepSeek) from reading the Odoo 18.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: 5 confirmed, 4 with no information of 9 versions.

Sources · Odoo 15.0

Confirmed on 2026-11-03 in branch 15.0 of OCA/server-ux.

terminal Installation and usage

OCA documentation · Odoo 18.0

To create new announcements a user should be in the Announcements Managers group. When your user has such permissions, this is the way to create an announcement:

  • Go to Discuss \> Announcements
  • Create a new one and define a title. This title will be shown in the announcement header.
  • Define the announcement scope:
  • Specific users: manually select which users will see the announcement.
  • User groups: users from the selected groups will be the ones to see the announcement.
  • Define the announcement body. You can use rich formatting and event paste your own html (editor in debug mode).
  • By default, the announcement will be archived. This is to prevent the announcement to show up before time.
  • Once the announcement is ready, unarchive it going to the Actions menu an choosing the Unarchive option.
  • Optionally you can set an announcement date to schedule the announcement. The announcement won't show up until that date.
  • If the announcement doesn't make sense once a date is passed, you can set a due date. From that date, the announcement won't be shown to anyone.

When a user in the scope of active announcements logs in, those will popup. The user has to mark them as read to continue working. If the announcement is set during the user session, the announcement will be eventually prompted in the top bar on the right part. The user click on the unread announcements icon (a speaker) and the announcements will popup for the user to check them.

Users can go Discuss \> Announcements to check current and past announcements. Announcement managers can also track which users have read the announcement.

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.