Onboarding in Confluence: make new hires watch the right spaces automatically

By Kayabyte · Updated 1 November 2026

Short answer: Confluence Cloud has no setting that makes a new hire watch a team’s spaces: each person watches for themselves, so onboarding usually means a checklist step (“select Watch”) or an admin adding watches one by one. A script can add them for a group, but only when you run it. Group Watchers: Auto-Watch Spaces & Pages for Confluence maps a group to a space, so anyone you add to the group starts watching within about an hour, and leavers lose the watches the app added.

A new hire should see what their team is writing from day one: the team space, the handbook, the incident log. In Confluence Cloud, watching is a personal setting, so nothing happens when someone joins the team. This guide goes through what you can do with Confluence alone, and where it stops.

What new hires get by default

Autowatch is on by default: people watch pages they create, edit or comment on. A new hire gets nothing from it until they have touched a page.
Watching a space covers all its pages and blog posts, and has to be switched on by that person (or by an admin, see below).
Watching doesn’t give access. If the space is restricted, the new hire has to be able to see it first.

Option 1: a step in the onboarding checklist

The simplest route: put a short “Follow these spaces” section in your onboarding page, with a link to each space and one line: open the space, select Watch. It costs nothing, and it works for a handful of spaces and a hiring pace of one or two people a month.

It breaks when the list of spaces changes, when people skip the step, or when the same new hire joins a team that follows eight spaces. Nobody checks that it was done.

Option 2: @mention or Notify watchers on key pages

For the few pages everyone must read, you don’t need a watch: mention the new hire in a comment, or add them to an announcement page. Neither is the same as a continuous feed from the space, and it’s a manual job for each person.

Option 3: an admin adds the watch for the new hire

Confluence’s REST API can set a watch for someone else, one person at a time. It needs the Confluence Administrator global permission, or Space Administrator on that space, and the header X-Atlassian-Token: no-check (Atlassian reference):

curl -s -o /dev/null -w "%{http_code}\n" -u "you@example.com:your-api-token" -X POST \
  -H "X-Atlassian-Token: no-check" \
  "https://your-site.atlassian.net/wiki/rest/api/user/watch/space/TEAM?accountId=NEW_HIRE_ACCOUNT_ID"

A 204 means the watch was added. If you have a group for the team, How to make a Confluence group watch a space or page has a script that walks the group’s members.

Run by hand, this is one more onboarding task. Run on a schedule, it needs somewhere to run, and it can’t tell watches it added from watches people chose:

People who unwatched on purpose are added again on the next run.
Leavers keep watching until someone removes them.
A cleanup step can’t tell which watches it may remove.

Option 4: keep a group mapped to the space

If you already manage a group per team (for example engineering), the easier way is to let group membership drive the watches. Group Watchers is the Confluence app I make for this:

Rule: you pick one or more groups and a space (all its pages and blog posts) or a single page. A space can have several rules, for example engineering plus product.
Joiners: add the new hire to the group, and the app adds their watch. It checks membership every hour, and right away when you change a rule or select Sync now.
No notification about the watch itself: people simply start receiving the normal Confluence notifications for the space.
Access: members who can’t see the space are skipped and counted in the rule status. The app checks them again every 6 hours and adds them once they have access, so a new hire who gets space permission a day later still ends up watching.
Leavers: when someone leaves every group in a rule, the app removes the watch it added. You can switch removal off, and watches people had before are never removed.
Unwatching: if a new hire unwatches, the app respects that and doesn’t add them back.
Where it runs: on Atlassian (Forge); it makes no calls outside Atlassian.

Two limits to know before you plan around it. Only Atlassian user accounts can watch, so portal-only customers and app accounts are skipped. And if your groups are filled by an identity provider, a new hire appears in the group when your provisioning puts them there, so check how quickly that happens in your setup.

It’s on the Atlassian Marketplace. Other apps do this as well; see Apps to make a Confluence group watch a space or page, compared.

One more thing: will they actually get email?

A new watcher may see little in their inbox. Edits and new pages in watched content go into the daily digest by default, while comments are emailed straight away. Each person can change this under their profile picture → Settings → Email. Add one line about it to the onboarding page; Confluence watching but no email? 5 things to check covers the rest.

FAQ

Can I make new hires watch a space automatically in Confluence Cloud? Not with a setting. Watching is personal, so you need a checklist step, an admin adding watches through the REST API, or an app that links a group to the space.

Does Autowatch cover new hires? Autowatch is on by default, but it only makes people watch pages they create, edit or comment on, so a new hire isn’t watching the team space until they have worked on a page in it.

Does watching a space give a new hire access to it? No. A watch never grants access, and people who can’t see the space are skipped by Confluence.

What happens to the watches when someone leaves the team? Natively nothing: they keep watching until someone removes the watch. Group Watchers removes only the watches it added, once the person has left every group in the rule, and you can switch that off.

How fast does Group Watchers add a new hire? It checks group membership every hour, and when you change a rule or select Sync now. A member who can’t see the space yet is checked again every 6 hours.

Confluence and Atlassian are trademarks of Atlassian. Kayabyte is an independent developer and is not affiliated with or endorsed by Atlassian.