Script for automating space or blog watching?

Hi everybody,

i have just started using Scriptrunner for Confluence.

A thing that i would like to do is to manage watchers of a space or blog centrally or to be able to add new users as watchers to spaces.

I had a look in Confluence API but i didn't manage to find something.

Thanx in advance for the help.


4 answers

1 accepted

This widget could not be displayed.

Here is the script i have created for managing Space watchers. It has as inputs a group of users, the Space key and the content type.

import bucket.user.UserAccessor
//import com.atlassian.confluence.user
import com.atlassian.spring.container.ContainerManager;
import com.atlassian.confluence.mail.notification.NotificationManager;
import com.atlassian.confluence.user.DefaultUserDetailsManager;
import com.atlassian.confluence.spaces.SpaceManager;
import org.apache.log4j.Level;
import org.apache.log4j.Logger;
def log = Logger.getLogger("com.onresolve.confluence.scripting.WatchSpace")
// Get the default Notification Manager
def notificationManager = (NotificationManager) ContainerManager.getComponent('notificationManager')
//def userDetailsManager = (DefaultUserDetailsManager) ContainerManager.getComponent('userDetailsManager')
// Get User Accessor
def userAccessor = (UserAccessor) ContainerManager.getComponent('userAccessor')
// Get Space Manager
def spaceManager = ContainerManager.getComponent("spaceManager") as SpaceManager
//def users = userAccessor.getUsers()
//define the group that you want to add as watchers
def group = userAccessor.getGroup('Add group here')
def users = userAccessor.getMemberNames(group)
//define the space that users will watch.
def space_for_watch = spaceManager.getSpace("Add space key here")
  log.warn (user)
  def username = userAccessor.getUser(user)
  boolean isWatching = notificationManager.isUserWatchingPageOrSpace(username, space_for_watch, null)
  if (!isWatching) {
//Choose the content type of space that users will watch. Add BLOG  for watching Space Blogs, leave blank for watching entire content
  notificationManager.addSpaceNotification(username, space_for_watch, BLOG)

This widget could not be displayed.

It looks like you can do it with the RPC and SOAP APIs. Although I haven't used any of these, it looks like watching pages and spaces can be automated with the following services:

  • WikiSoapService
  • XhtmlSoapService
  • ConfluenceSoapService
  • NotificationsRpc
  • ConfluenceXmlRpcHandler

You can also do some automation by writing a user macro, although my success with page and space watching has been mixed with this approach.

Hey Matthew thanks for the help. I managed to write a script for adding space watchers. Is listed in my answer below. Cheers

This widget could not be displayed.
Nicholas Muldoon Community Champion Oct 02, 2015

Hi Kostas,

I know you got this sorted for your instance. If anyone stumbles on this and wants a turnkey solution I invite you to look at Better Blogs for Confluence. It is a paid add-on that allows Space Administrators to subscribe users and groups to email notifications of new blogs in a space.

At Twitter we needed this feature to ensure every member of our product, design and engineering organisation (>1,500 people) were notified of new blog posts in the Engineering space. The Engineering Blog enabled VP's to communicate one-to-many and teams to share details of the technology and features they were working on. It didn't make sense to ask every new employee to subscribe to the blog in that space, hence Better Blogs was born.

With Better Blogs you can keep everyone informed, and do so with ease. For those wishing to take advantage of early bird pricing use the promotion code HHYUWD before the end of October 2015.

If you have feedback on the Better Blogs for Confluence add-on contact me via or +1 415 568 7064.

Thanks Kostas, hope you don't mind me dropping this note here.


Nicholas Muldoon

Hi @Nick Muldoon, no problem at all. Thanks for the update on that. Indeed for large instances of Confluence, asking new users to subscribe to the blog doesn't make sense. Our instance has 90 users so far, so i use the script every time that a new user is added. I will take a look on Better Blogs. For any comment, feedback etc i will let you know. Cheers, Kostas

Nicholas Muldoon Community Champion Oct 07, 2015

Thanks Kostas

This widget could not be displayed.

And how about this feature? Please vote!

Suggest an answer

Log in or Sign up to answer
Atlassian Summit 2018

Meet the community IRL

Atlassian Summit is an excellent opportunity for in-person support, training, and networking.

Learn more
Community showcase
Published yesterday in Confluence

Add-on evaluation with confluence templates

Atlassian market place contains number of Apps/Addons which improves the capability of out of the box Atlassian products. It is good to follow a plugin evaluation process before install add-ons. So t...

34 views 5 3
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you