Status
Tech review



Field code%{issue.watcher}
Type

Available since



%{issue.watcher}



Read



Returned valueA comma-separated list of user names
Output data type

Example outputusername1, username2, username3




Write



Valid text input

A comma-separated list of user names, group names or project roles names (info)

Valid numerical input


Example inputusername1, username2, username3



Sets the watchers of an issue replacing existing watchers! If you just want to add new watchers have a look at New watchers.

Prefixes + and - can be used to add or remove watchers.

InputDescription
Albert, Richard, JohnReplaces the current watchers with users Albert, Richard and John.
+ Developers, AdministratorsAdds every user in project roles or groups Developers and Administrators as current watchers.
- Testers, Administrators, + Albert, RichardRemoves users in project roles or groups Testers and Administrators, and adds users Albert and Richard as watchers.



Use this field to add or remove watchers to linked issues, sub-tasks or issues returned by JQL.

To learn more about this writable field, check the following use cases: