Object Watch
Watching an object gets you automatic notifications when it changes — useful for staying current on tickets or records you care about without checking back manually.
Watching manually
The watch control is an eye icon in the object's top bar. With no watchers yet, a single click starts watching directly. Once there's at least one watcher, hovering the icon opens a menu with Stop/Start watching, plus up to 5 watchers listed and a "View N more" link to the full list. The icon turns blue while you're watching.
Becoming a watcher automatically
- Anyone who is @mentioned on the object, or who comments on it, becomes a watcher.
- External users (customers via Sites or email) automatically watch any object they create.
- Internal users do not automatically watch objects they create, by default — an administrator can enable automatic watching for creators on a per-type basis.
What triggers a notification
A comment added, a workflow state change, a priority change, or a label update.
| External comment | Internal note | |
|---|---|---|
| Internal watchers | ✓ | ✓ (planned) |
| External watchers | ✓ | — |
| Internal restricted users | ✓ | — |
Finding the objects you watch
The StarQL system attribute @Watcher filters on what you watch, so a view, widget, or site list
can show it: @Watcher = userCurrent(). See StarQL.
With automation
Email automation actions can target Watchers as recipients, letting you extend the built-in triggers with custom notification rules on top of watcher status. See Workflows & Automation.