--- title: "Events" canonical: "https://support.appfire.com/space/CDML/649759655/Events" format: markdown --- > Macro (aura-html) ![event triggers and actions](media://0592b22a-c1f3-43b3-9406-f5d261351d4a) ## Overview > Macro (excerpt) > > Events are internal notifications that can be used to trigger action macros ![Events](media://dceed065-1638-43c1-a1e9-3e970b4ac6bc) As content producers interact with content, and the workflow itself, internal notifications called **Events** are generated within the Comala Document Management app. ![Triggers](media://0939785a-cf10-4588-9858-ec2b4d75fef3) The workflow can use one or more [Triggers](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649563178) to listen for an event. ![Actions](media://a1ab1714-b496-4afc-a0d3-70baa12dab31) And, upon detecting one, perform one or more [Actions](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649858941). This process, of an event triggering an action, enables the workflow to react to a wide range of user interactions and workflow situations. For example, you could - send custom emails when someone is assigned to a review - start a remote publishing process when content is approved - add or remove labels when a document changes the workflow state - add an on-screen message notification to inform your editing team of reviewer decisions or other document workflow activity ## Events | Event | Notes | Ver | | --- | --- | --- | | ## Assignee
The `approval` parameter must be set on the `trigger` for these events to work.
[Macros](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650151673): [approval](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649662337) | | `pageapprovalassigned` | Page reviewer assigned
> Macro (contentbylabel)
Note: the `pageassigned` event was deprecated in v4.0.0. For any triggers using this event in legacy workflows please replace with `{trigger:pageapprovalassigned|approval=approvalname}` | | | `newsapprovalassigned` | Blog post reviewer assigned
> Macro (contentbylabel) | | | `approvalunassigned` | Reviewer unassigned
> Macro (contentbylabel) | | | ## Attachments
Only for content that the workflow is applied to. | | `attachmentadded` | Attachment created
> Macro (contentbylabel) | | | `attachmentschanged` | Attachment created, updated or removed
> Macro (contentbylabel) | | | `attachmentupdated` | Attachment updated (eg.new version uploaded)
> Macro (contentbylabel) | | | `attachmentremoved` | Attachment removed
> Macro (contentbylabel) | | | `attachmentversionremoved` | Attachment version removed
> Macro (contentbylabel) | | | ## Content changes
Only for content that the workflow is applied to. | | `pagecreated` | Page created
Only works in [Space Mode](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649531846).
> Macro (contentbylabel) | | | `newscreated` | Blog post created
Only works in [Space Mode](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649531846).
> Macro (contentbylabel) | | | `pageupdated` | Page edited
For simple state transitions, you can also use the `updated` parameter on the `state` macro.
> Macro (contentbylabel) | | | `newsupdated` | Blog post edited
For simple state transitions, you can also use the `updated` parameter on the `state` macro.
> Macro (contentbylabel) | | | `pagemoved` | Page moved
> Macro (contentbylabel) | 3.1+ | | ## Content reviews
The `approval` parameter must be set on the `trigger` for these events to work.
By default, the **trigger** will only activate once all reviewers have agreed to Approve or Reject the content. To activate it for each individual Approve or Reject, set `partial=true`.
For simple state transitions, you can also use the `approved` and `rejected` parameters on the `state` macro.
[Macros](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650151673): [approval](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649662337), [state](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649531575), [approve-page](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649826933), [reject-page](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649563317), [approve-children](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649531735), [reject-children](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649793152) | | `pageapproved` | Page approved
> Macro (contentbylabel) | | | `newsapproved` | Blog post approved
> Macro (contentbylabel) | | | `pagerejected` | Page rejected
> Macro (contentbylabel) | | | `newsrejected` | Blog post rejected
> Macro (contentbylabel) | | | ## Comments
These events occur when a [Confluence comment](https://confluence.atlassian.com/doc/comment-on-pages-and-blog-posts-139483.html) is created, updated, removed or resolved, either at the bottom of any page or blog post, or as an inline comment by highlighting specific text on the page. | | `pagecommentcreated` | Comment created
> Macro (contentbylabel) | | | `pagecommentupdated` | Comment updated
> Macro (contentbylabel) | | | `pagecommentremoved` | Comment removed
> Macro (contentbylabel) | | | `inlinecommentcreated` | Inline comment created
> Macro (contentbylabel) | | | `inlinecommentresolved` | Inline comment resolved
> Macro (contentbylabel) | | | ## pdf export
These are **ONLY** for export events that occur when using the [pdf-export macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649955790) and [K15t Scroll PDf Exporter app](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649923655).
[Macros](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650151673): [pdf-export](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649955790) | | | `pdf-export-success` | pdf export success
> Macro (contentbylabel) | | | `pdf-export-error` | pdf export failure
> Macro (contentbylabel) | | | ## Labels
Only for content that the workflow is applied to.
[Macros](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650151673): [set-label](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649531509), [remove-label](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650217730) | | `labeladded` | Label added
> Macro (contentbylabel) | | | `labelremoved` | Label removed | | | > ✅ The `labeladded` and `labelremoved` events allow the workflow author, the versatility to execute actions when a label has been added or removed like sending an e-mail or adding the same label again. | | | ## State
These events occur when a workflow [transitions](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649563425) to a new state, or when a state expires.
Note: You must specify the `state` parameter in the `trigger` for these events.
[Macros](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650151673): [state](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649531575), [set-state](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649727251), [set-state-expiry](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649563686) | | `statechanged` | Page state changed
> Macro (contentbylabel) | | | `pagestatechanged` | Page state changed
> Macro (contentbylabel) | | | `newsstatechanged` | Blog post state changed
> Macro (contentbylabel) | | | `stateexpired` | State expired
States can be set to expire using the `duedate` parameter on the `state` macro, or via the `set-state-expiry` macro.
For simple state transitions, you can also use the `expired` parameter on the `state` macro.
> Macro (contentbylabel)
See also: [Expiry Dates](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649890606) | | | `stateexpiryupdated` | State due date updated
> Macro (contentbylabel) | | | ## Tasks
In the `trigger` macro, you can specify the `task` parameter to filter to events for a specific task, otherwise the trigger will apply to events for all tasks.
[Macros](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650151673): [task](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650315819), [complete-task](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650251348) | | `taskcreated` | Task created
> Macro (contentbylabel) | | | `taskassigned` | Task assigned
> Macro (contentbylabel) | | | `taskcompleted` | Task completed
> Macro (contentbylabel) | | | `taskexpired` | Task expired
> Macro (contentbylabel)
See also: [Expiry Dates](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649890606) | | | ## Read Confirmation
These events occur when a [read confirmation is added ](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649761089)to a workflow final state, a read confirmation is confirmed or read confirmation set due date expires. | | `confirmationdue` | Read confirmation hits the set due date and becomes overdue
> Macro (contentbylabel) | | | `confirmationrequested` | Read confirmation is added to a final state in a workflow
User is assigned as a reader to a read confirmation
New read confirmation request is sent
> Macro (contentbylabel) | | | `confirmationcompleted` | Read confirmation overall status reaches `status = complete`
> Macro (contentbylabel) | | | `confirmationacknowledged` | User confirms reading the content
> Macro (contentbylabel) | | | ## Workflow parameter
The `parameter` parameter must be set on the `trigger` for this event to work.
[Macros](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650151673): [workflowparameter](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650348884) | | `pageparameterupdate` | Workflow parameter updated
Only applies to page-level parameter changes (set `edit=true` on the `workflowparameter` macro)
> Macro (contentbylabel) | 4.15+ | ## Custom events The events listed above can be used to trigger custom events. > Macro (excerpt-include) For more information, see: [Triggers](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649563178). ## See also [Workflow Authoring Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/648611901) - [Triggers](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649563178) - [Actions](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649858941) - [Parameter References](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649760641) [Developer Guides](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649330694) - [Workflow Events](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649923526)