Notifications provide a way of monitoring changes in pages and spaces in Confluence. Notifications can be received by users via email. There are two types of notifications:
- report notificiations - these notifications are emailed reports (ie all changes to a given space in a 7 day period)
- change notifications - these are notifications of individual changes (ie a single page edit)
Change Notifications
Users can control the behaviour of the notifications. Here is the what, when, who, where, how and why:
- What - user can choose to watch Spaces or individual pages, though if a space is being watched you can't also watch a page in the space.
- When - User can specify thier time zone and specfy when and how often they would like to receive notifications
- Who - Users can specify to watch anything they create, edit or comment on by default. Could also have the option of watching another user and monitor their creates, edits and comments...
- Where - there should be a cofig page accessible through View My Profile that allows management of watches and to configure preferences.
- How - A link on top (or bottom) of every page called watch this page that allows the user to add a watch. If the user is watching the page a stop watching link should be shown. A similar link is need on the space too. Though if the space is being watched by the user the watch this page link should not be visible.
- Why - because nobody likes to miss out!

There should also be some preferences that the user can set - (default in caps)
- Always watch items I create (YES/no)
- Always watch items I edit/comment on (YES/no)
- Notify me by email (yes/NO)
Report Notifications
Initially there will be only one report notification - a daily email containing a list of the pages added and edited in all spaces that the user can see.
There should also be some preferences that the user can set - (defaults in brackets)
- Users Timezone (default is server time zone)
- What time to send 'report' notifications (9am)
- How often to send 'report' notifications (daily)
CHARLES We should also allow customisation of which spaces are included in the 'recent changes' list on the dashboard for a user. For example, I'm not that interested in what's changed recently in the marketing space, but sometimes there are a lot of changes in those spaces that push things I am interested in (like confluence dev changes) off the bottom of the list.
For Confluence 1.0 Release Candidate 1 (Friday, February 6th)
- Define a generic notification / queue model
- Have single Daily Report option on the Edit My Profile page that will send an email report of all the changes on all speces in the last 24 hours.
- Have watching of pages and spaces completed

Comments (15)
Jun 24, 2004
Dan Keldsen says:
Personalized RSS Feeds. Embrace it, love it, feel it. No really, extremely power...Personalized RSS Feeds. Embrace it, love it, feel it. No really, extremely powerful and useful. Having e-mail as a complement to that, obviously powerful as well, but RSS as a personalized project watcher, very nice.
Also, slightly related, love the idea of displaying RSS via your Macro language. But is there a way to actually CONSUME the feeds? Specifically to be able to search and otherwise mangle it within Confluence?
Dec 10, 2004
John Fereira says:
This is a notification idea but perhaps might also be related to any pages relat...This is a notification idea but perhaps might also be related to any pages related to using the Confluence API.
What I would like to do provide a method notifying confluence-administrators that a new user has signed up and would like permissions to access a space beyond what I might have configured for confluence-users or anonymous users.
My thought was that the signup.vm file would be modified which allowed a user to send a note to confluence-administrators. The action class for the form (com.atlassian.confluence.user.actions.SignupAction) would then have to be extended with implementations for getNote(), setNote() methods. The dosignup action would then provide notification via email to confluence-administrators.
Anyone done anything like this?
Jun 23, 2006
Peter R. says:
I am getting user feedback that when they post a comment to a page (or news item...I am getting user feedback that when they post a comment to a page (or news item) that they feel they should be automatically subscribed to any future changes to the page (news item) so that they will be aware of responses.
Seems logical to me. Any ideas how this might be able to be implemented?
Jun 23, 2006
David Peterson says:
Hmm...not a bad idea. The best way would be to have it added as an option in Con...Hmm...not a bad idea. The best way would be to have it added as an option in Confluence, but in the meantime, you should be able to create a plugin which has an event listener, waiting to get notified about a new comment. When it gets a 'CommentAddedEvent' it can then add the user doing the comment as a watcher for the page/news item the comment occurs on.
Jun 24, 2006
David Peterson says:
Ok, I got all inspired and whipped up a plugin do do what you described. You can...Ok, I got all inspired and whipped up a plugin do do what you described. You can grab it here. Let me know if you have any questions, problems or suggestions.
Jun 27, 2006
Peter R. says:
David, You Rock\! Downloaded and testing now, thanks\!\!\!David, You Rock! Downloaded and testing now, thanks!!!
Feb 12, 2007
Rob Williams says:
Here is a new suggestion (at least I think new): Quite often, a page requires i...Here is a new suggestion (at least I think new):
Quite often, a page requires input from many different parties. Furthermore, just asking people to make a contribution does not get you there many times, as you did your part and promptly forgot about it, only to find, the next time the info in the page is needed, the other holes were never filled.
What I would like is the ability to edit a page, and then when I get to a part where I want someone else to make a contribution, or at least approve the content I put in, put a tag in the page saying so, with their user name or email, and have it notify them, and then track it.
This may sound like workflow, but I don't think so. Could be very simple.
Feb 12, 2007
Bob Swift says:
I think this is an interesting and useful idea.I think this is an interesting and useful idea.
Feb 14, 2007
Grahame Turner says:
Essentially what you're suggesting is the equivalent of the Watchlist page on Wi...Essentially what you're suggesting is the equivalent of the Watchlist page on Wikimedia-platforms (Wikipedia or Uncyclopedia, e.g.), because I am a huge fan of those pages, and less so of the concept of having changes e-mailed to me. The particular project I'll be working on has a lot of pages I'll create myself, and want to keep an eye on to sate the control freak in me, but also has a lot of potential for edits--local and global to my project.
I just wanted to chip in my two cents about how extremely useful this will be. E-mail clutter is not fun.
Apr 25, 2007
Martin Cooper says:
There needs to be a way for an administrator to notify all Confluence users of a...There needs to be a way for an administrator to notify all Confluence users of a global event, by e-mail. For example, if the host name or port number change, for whatever reason, the administrator needs to be able to notify all of the users of the new URL for accessing the wiki. Confluence has everything needed to send out such a notification.
Perhaps this functionality already exists somewhere and I'm just missing it. I know it doesn't fit under either "report notifications" or "change notifications" per se, but it sure sounds like a type of notification to me.
Apr 25, 2007
Peter R. says:
Completely agree with you on this. Right now we do a DB query to pull out logon ...Completely agree with you on this. Right now we do a DB query to pull out logon IDs, then manually convert to email address (stored in LDAP, not Confluence), and then do a mail merge and send via Outlook. Would be great to go to Confluence, put in the message and click send.
Further, would be extremely helpful to be able to target certain groups instead of everyone. For example, to be able to send an email to all Space Admins, letting them know of upcoming upgrades such as our upcoming jump to the newer version of Themebuilder, which is going to totally hose current customized themes.
Feb 18
Jason Koziara says:
Somewhat along these lines, does anyone know of a way to create a global message...Somewhat along these lines, does anyone know of a way to create a global message in Confluence similar to the example below (taken from Jira)?

Feb 18
Peter R. says:
What we do is go into the "Custom HTML" part of the admin console and then add o...What we do is go into the "Custom HTML" part of the admin console and then add our announcements to the "At end of the HEAD" section. For example, here's what we have there right now:
Yes, that's a placeholder but you get the idea. We yank out the the commenting part, put in our message (where it currently says "Wiki Unstable") and save it. Displays on every page.
Hope this helps.
Feb 18
Jason Koziara says:
It does thanks. I was hoping to find a way to put it where the Site Welcom...It does - thanks. I was hoping to find a way to put it where the Site Welcome message is shown, but it doesn't appear that you can inject HTML there...
Feb 19
Peter R. says:
True, it won't take HTML but it will take Wiki Markup. We initially used that as...True, it won't take HTML but it will take Wiki Markup. We initially used that as our notification area but discovered that very few people actually visit the Dashboard to see it. Most go directly into the Spaces in which they work.