Status
Tech review



Field code%{issue.watcher}
Type

Available since



%{issue.watcher}



Read



Returned valueA comma-separated list of user names of current watchers of the issue.
Output data type

Example outputusername1, username2, username3




Write



Additional information for writing valuesSets watchers of an issue. Can be used to add or remove watchers to linked issues, sub-tasks or issues returned by JQL, but requires to use operator '+' and '-'. Also can be used to copy watchers between issues.

Allowed input 

comma separated list of user names, group names or project roles names.

Allowed input 


Example input

Albert, Richard, John

+ Developers, Administrators

- Testers, Administrators, + Albert, Richard



Prefixes + and - can be used to add or remove single users or set of users.

Albert, Richard, John : sets 3 users as watchers replacing current ones.

+ Developers, Administrators : adds every user in project roles or groups Developers and Administrators to current watchers.

- Testers, Administrators, + Albert, Richard : removes users in project roles or groups Testers and Administrators and adds users Albert and Richard as watchers.


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