--- title: "Notifications" canonical: "https://support.appfire.com/space/CDML/649957056/Notifications" format: markdown --- > Macro (aura-html) ## Overview > Macro (excerpt) > > Keep content producers informed of workflow progress. Workflows can utilise a wide array of notifications to keep content producers informed of progress. ## Workbox notifications Confluence [workbox notifications](https://confluence.atlassian.com/doc/workbox-notifications-284365963.html) will be sent when - [Reviewers are assigned](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650347935) to [Approvals](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650153766) - Tasks are [created](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649759190), [edited](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649563090) or [assigned](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649792357) - States or tasks reach their [Expiry Dates](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649890606) - [Read Confirmations](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649791545) are added and a read confirmation event occur - users are assigned as readers, read confirmation is completed In the user profile - the** **[Document Actions tab](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650152557) displays the current document actions for the user - the [Read Assignments tab](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649629203) displays current pending and overdue read assignments for the user ## On-screen notifications On a page with an applied workflow, the [workflow status bar](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650117676) displays - the current workflow state breadcrumb - the tasks breadcrumb displaying the number of incomplete tasks ![image](media://d3edae91-7e1d-4b63-b4be-6eaf34f923e7) ### State breadcrumb (1) Displays name of the current workflow state for the page or blog post together with a colored state indicator circle. - if the [state status indicator circle](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650152863) is filled,> Macro (inline-media-image) > Macro (inline-media-image) , it means the user is assigned to a [content review](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650313809) Choosing the state breadcrumb opens the workflow popup. ![image](media://16251958-8955-41e2-a75e-ac357f0dc627) The workflow popup displays the transition options from the state (if any). ### Tasks breadcrumb (2) Displayed if there any workflow tasks added by a user or by the workflow that have not yet been completed. The current number of outstanding tasks is appended to the breadcrumb. Choosing the tasks breadcrumb opens the tasks popup. ![image](media://d660fa35-1fb4-471b-bf01-fc1b654b68a4) > ℹ️ A blue dot • indicates tasks the current user is assigned to. - assigning a task (by default) generates a notification for the assignee - outstanding tasks for a user are displayed in the user profile [Document Actions](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650152557) ### Read Confirmation When a read confirmation is added to a page or blog post, a read confirmation breadcrumb is added to the page header (**A**) and page footer (**B**) showing the current status of a read confirmation on the content. ![image](media://959227ab-f082-475a-8b90-e43605c20730) Choose either breadcrumb to open the [read confirmation popup](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650218477) for details of the read confirmation. - assigning a read confirmation (by default) generates a notification for the assigned reader - outstanding read confirmations for a user are displayed in the user profile [Read Assignments](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649629203) ## Message banners Message banners can be displayed during page creation when the workflow is applied as a space workflow - [space mode](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649531846)) or when viewing a page. ![image](media://9244348b-6521-4b40-8d79-f0ba0ddf1932) ![image](media://18b3e0de-146d-4a21-b92e-5347fa3ce916) ![image](media://2fd7f4ca-8a8b-43f6-8666-737102f5f47a) ![image](media://c84b922c-367f-48f8-a65a-c9f0ae099139) For more information, see: - [workflow-instructions macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650119824) - [set-message macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650153597) - [trigger macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649859133) ## Headers and footers Content, including [report macros](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649954318) can be added to the page header and footer by an applied workflow. For more information, see the following macros - [workflow](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649662219) - [pageheader](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650348817) - [pagefooter](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650251276) Content can also be added to these macros editing the workflow using the [Page Layout options in workflow builder visual editor](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649693867). ## Email notification A user needs at least **Pages - Add** permission in the space or else they will not receive any notifications when they are assigned to a task, approval or read confirmation. By default, email notifications will be sent when - [Assigning reviewers](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650347935) to [Approvals](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650153766) (if a user assigns themself as a reviewer to an approval, the email notification will not be sent) - Tasks are [created](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649759190), [edited](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649563090) or [assigned](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649792357) - States or tasks reach their [Expiry Dates](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649890606) - [Read confirmation](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650347654) is requested for a final state In addition, [custom email notifications](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649924039) can be sent in response to [Events](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649759655). For more information, see: - [Notifications - Global](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649530054) - [Notifications - Space Tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650119000) - [send-email macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649924039) ## Comments Page and blog post comments can be added by the workflow. For more information, see: - [add-comment](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650348750) ## Macros > Macro (contentbylabel) ## App configuration | Setting | Where | Notes | | --- | --- | --- | | **Approval – Assignee** | - [Notifications - Global](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649530054) - [Notifications - Space Tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650119000) | Should assigned reviewers receive notifications about review updates? | | **Email Any Address** | - [Configuration - Global](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649889951) | Should the {send-email} macro be able to use email addresses that are not associated with registered users? | | **State Expired Notification** | - [Notifications - Global](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649530054) - [Notifications - Space Tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650119000) | Should page watchers recieve notifications about state expiry? | | **Task – Assignee** | - [Notifications - Global](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649530054) - [Notifications - Space Tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650119000) | Should task assignees receive notifications for taks they are assigned to? | | **Task – Page Watchers** | - [Notifications - Global](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649530054) - [Notifications - Space Tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650119000) | Should page watchers receive notifications about workflow tasks? | | **Read Confirmation** | - [Notifications - Global](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649530054) - [Notifications - Space Tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650119000) | Should Read Confirmation assignee(s) receive notifications for all read confirmation events? | | **Workflow Activity and Drafts Visibility** | - [Configuration - Global](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649889951) - [Configuration - Space Tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649956239) | Should View-only users be able to see workflow information?
Note: Does not affect message banners unless their parameters state otherwise. | ## See also [Workflow Authoring Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/648611901): - [Actions](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649858941) - [Event references](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649925434) [User Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/648907144): - [Workflow Popup](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649659846) - [Content reviews](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650313809) - [Tasks Popup](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649824290) - [Read Confirmation](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649791545) [Reporting Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649070833): - [Report on states](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650216427) - [Report on tasks](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649661358)