---
title: "addWatch"
canonical: "https://support.appfire.com/space/CSOAP/68457745/addWatch"
format: markdown
---
> Macro (aura-html)

See also: [Actions](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68458401)

> Macro (details)
> 
> | **Description** | Add watch to page or space for a user. If userId is not provided, the current user will be used. On server, only the current user is valid for space watches. |
> | --- | --- |
> | **Required Parameters** | [space](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68459481) or [id](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68454565) |
> | **Optional Parameters** | [title](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68457665), [userId](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68459187), [children](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68455007), [descendents](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68458756) |
> | **Type** | [Create](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68455033/Action+Types#ActionTypes-Create) |
> | **Category** | [Content](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68455044/Action+Categories#ActionCategories-Content) |
> | **Output Formats** |  |
> | **Replacement Variables** |  |
> | **Hosting** | cloud,server,datacenter |
> | **Since Version** |  |
> | **Examples** | [addWatch](https://appfire.atlassian.net/wiki/spaces/CSOAP/pages/68458176/Examples#Examples-addWatch) |

## Related How To's

> Macro (cql-query)