History: Watch

            {syntax type="markdown"  editor="wysiwyg"} # User Watches

If a user wants to receive an email when content is added or edited—such as wiki pages, forum topics, or (almost) any other content — they can create a watch. Watches can also be set for group notifications.

For example, for the page ((Using Wiki Pages)) on this documentation site, a registered user can monitor it (i.e., add a "User Watch"):

{img src="display2175" link="display2175" class="thumbnail img-responsive" alt="Watch feature screenshot" title="Wiki page watch icons"}

**Contents of this page**

##$ 'My Watches' User Interface 
A user can manage watches on many Tiki objects (such as new articles) via the My Watches page under their My Account menu: 
**User menu > My Account > My Watches** (*tiki-user_watches.php*).

The User Watches and Preferences page includes several tabs (depending on which features are enabled on the site):

1. Report preferences 
     {img src="display2176" link="display2176" width="500" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}
2. My Watches 
     {img src="display2177" link="display2177" width="500" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"} 
    - You can select an event type from a list, which varies depending on the enabled features and your permissions on the site. 
        
         {img src="display2178" link="display2178" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}
3. Notification Preferences 
     Choose whether to receive notifications for your own changes. If unchecked, you will not receive notifications for changes you made. 
     {img src="display2179" link="display2179" width="500" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}


##$ Types of watches 
You can click the {icon name="eye"} icon near the top of many pages (often in a dropdown menu or popup). Clicking it activates a watch and changes to {icon name="eye-slash"} (indicating that you have set a watch).

- Wiki page watch: Notifies you of edits and new comments/replies.
- Wiki structure watch: Notifies you when new pages are added to the ((structure)).
- Wiki sub-structure watch: Notifies you when objects are added or removed in a sub-section and its descendants.
- Content category watch: Notifies you of objects added or removed in a ((Category)).
- Category and descendants watch: Notifies you of changes in the category and all nested categories.
- Forum watch: Notifies of new topics only (not replies).
- Forum topic watch: Notifies of new replies in the thread. It does not notify you of new topics or replies to the new topics, unless you have subscribed also to that Forum.
- Forum topics and threads watch: Notifies of new topics and all replies.
- Calendar watch: Notifies you of added or edited events. (As of ((Tiki28)) (2025), there is no way to watch all calendars at once.) 
    - **Note:**
         If you have multiple calendars, deselect all but one to see the watch icon for a specific calendar.
- And similarly, for **all the other Tiki objects** that accept "User Watches" {icon name="eye"}. See below the table listing all Tiki objects accepting them.


Admins can configure ((Group Watches)) to notify user groups about changes:

- a "**group watch**" on a **structure** {icon name="group"} (to force one or several groups of users to watch for changes on the ((Structure)) of wiki pages where that wiki page belongs to).
- a "**group watch**" on a **category** {icon name="group"} (to force one or several groups of users to watch for changes on the ((category)) of objects).
- a "**group watch**" on a **forum** {icon name="group"} (to force one or several groups of users to watch for all topics of this forum), or
- a "**group watch**" on a **forum topic and threads** {icon name="group"} (to force one or several groups of users to watch for all topics and all their replies of that forum).
- a "**group watch**" on a **calendar** {icon name="group"} sends you information of the new events added or edited in that specific calendar. As of ((Tiki10)) (2012) there is no way yet to watch all calendars at once. 
    - **Note about Calendar Watches:**
         Please note that if you have more than one calendar created in your site, you have to deselect all calendars except one (from the list of viewable calendars to be displayed) so that you can see the icon to group watch that single Calendar.
- And similarly, for **all the other Tiki objects** that accept "((Group Watches))" {icon name="group"}. See, below, the table listing all Tiki objects accepting them.


##$ How to turn off watches 
To turn off a user watch, a user can either:

1. Click the "stop-monitoring" icon {icon name="eye-slash"}. It will change to indicate the page is no longer watched. 
     or <br /> <br />
2. Or, go to My Watches and delete the desired entries. 
     <br /> {BOX()}{img src="display2180" link="display2180" width="600" rel="box[g]" imalign="center" desc=" " align="center" }{BOX}


To be removed from ((Group Watches)):

- Ask a site admin to remove you from the group.
- Or, request the group watch to be reconsidered—users may prefer setting their own watches now that the feature is widely understood.


Note: Some older Tiki documentation suggests that minor changes might not trigger a notification. This may no longer apply.

##$ Which sections can be watched 
{TRACKERLIST(trackerId=>7,fields=>104:70:68,sort_mode=>f_104_asc,showtitle=>n,showlinks=>y,showdesc=>n,showinitials=>n,showstatus=>n,status=>opc,filterfield=>68,filtervalue=>yes)}{TRACKERLIST}

You will receive notifications when items are: Added to or removed from a category, **but also** when items in the category are modified. This can be useful for Tiki as a ((Document Workflow)) or in ((Project Management)).

Watches can also be applied to ((Group Watches|groups)), so all members receive notifications.

##$ How to enable/disable this feature 
To activate or deactivate watches: 
You must go to **Settings**-> **Control Panels** -> **Global Setup** -> **Features**, and under **Global features** tab, scroll down to **Watches** feature and check/uncheck **User Watches** and/or **Group watches**.

## Related pages

- ((Mail notifications)) for admins
- ((Forum User))
- ((Categories))
- ((Structures))
- ((Group Watches))
- ((Group Alert))
- ((Daily reports))



{DIV(class=titlebar)}Alias names for this page{DIV}


(alias(Watches)) | (alias(User Watches)) | (alias(User watch)) | (alias(Pull)) | (alias(Watching)) | (alias(user watches)) | (alias(userwatches))