Managing Notifications in Confluence

This page is about the notification-and-task dialog, known as the Confluence 'workbox', which drops down when you choose the  icon on the Confluence page header.

Do you want to manage your notification email messages instead? See Subscribing to Email Notifications of Updates to Confluence Content.

Managing your notifications in the Confluence workbox

The workbox displays all notifications collected from Confluence page watches, shares, mentions, and tasks. If your Confluence site is linked to a JIRA issue tracker, you will also see JIRA notifications in your workbox.

You can view your notifications and convert them to personal tasks. Use the inline actions to reply to comments, like a comment or page, or watch a page. Follow the links in a notification to open the relevant page or blog post. With JIRA integration, you can watch or unwatch issues, comment on issues, or follow the link to open the issue in JIRA.

The workbox displays your notifications and your personal tasks in separate tabs.

To manage your notifications:

  1. Choose the workbox icon  in the Confluence page header.
    • A number may appear on the workbox icon, indicating the number of unread notifications waiting for your attention.
    • You can use the keyboard shortcut: Type g then n. (When in the Confluence editor, click outside the editor pane before pressing the keyboard shortcut keys.)

  2. Choose the notifications icon: 
  3. Choose a notification from the list, to see the notification details. Now you can do the following:
    • Choose a link or Open to open the related page, blog post, or comment. The page will open in a new tab in your browser.
    • Choose Like or Unlike to let people know that you like, or have stopped liking, a page, blog post, or comment.
    • Choose Watch or Stop Watching to receive notifications, or stop receiving notifications, about a page or blog post.
    • Choose Reply to respond to a comment inline, within the workbox.
    • Choose the 'add task' icon to flag a notification as a task. The notification will remain in the notification list too.

Screenshot: Your Confluence notifications in the workbox

NotificationDialog

Which notifications are included?

The workbox displays a notification when someone does one of the following in Confluence:

  • Shares a page or blog post with you.
  • Mentions you in a page, blog post, comment or task.
  • Comments on a page or blog post that you are watching.
  • Likes a page or blog post that you are watching.

The workbox does not show notifications triggered because you are watching a space. Only watches on pages and blog posts are relevant here.

The notification in your workbox appears as 'read' if you have already viewed the page or blog post.

If your Confluence site is linked to JIRA, you will also see the following JIRA notifications in your workbox:

  • Comments on issues that you are watching.
  • Mentions.
  • Shares of issues, filters and searches.

Keyboard shortcuts

Key Action
g then n Open the Confluence workbox.
j Move down to the next entry in the notification list.
k Move up to the previous entry in the notification list.
n Move down to the next notification for a particular page or blog post.
p Move up to the previous notification for a particular page or blog post.
Enter Open the selected notification.
u Return to the notification list after opening a particular notification.

Managing notifications with Confluence mobile

You can view and respond to your notifications on your phone or other mobile device too. See Using Confluence on a Mobile Device for more about mobile platforms.

MobileNotifications

Notes

  • Read notifications are automatically deleted after 2 weeks.
  • Unread notifications are automaticallydeleted after 4 weeks.
  • You cannot delete your notifications yourself.
  • If a new notification arrives while you have workbox open, the count appears on the workbox icon  but the notification is not added to the workbox. You need to close workbox and re-open it to see the new notification.

  • The ability to receive notifications from JIRA or another Confluence site is available in Confluence 4.3.3 and later. To receive JIRA notifications, you need JIRA 5.2 or later.

  • Administrators can enable and disable the workbox on your Confluence site. They can also connect a JIRA site or another Confluence site, so that notifications from those sites appear in your workbox too. See Configuring Workbox Notifications.
  • The Confluence workbox is provided by a set of plugins. To remove the personal notifications and tasks functionality from your site, you can disable the following plugins. See Disabling or Enabling a Plugin for instructions. Disabling these plugins will disable the entire workbox . It is not possible to disable only tasks or only notifications:
    • Workbox - Common Plugin
    • Workbox - Host Plugin
    • Workbox - Confluence Provider Plugin
  • If you want to re-enable the plugins, do so in the following order: Common Plugin, Host Plugin, Confluence Provider Plugin.
  • There is no option to disable the workbox for an individual user.
  • The workbox is not available in Confluence Data Center (clustered). The plugin will be installed and enabled, but it will detect that the site is in clustered mode and will not display the dialog.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport