---
title: "Actions"
canonical: "https://support.appfire.com/space/CDML/649858941/Actions"
format: markdown
---
> Macro (aura-html)


![image](media://fdc764bb-d6c0-407a-a0d2-a18039c3ef0c)

## Overview

> Macro (excerpt)
> 
> Actions are macros added to a workflow trigger allowing the automation of common tasks and create custom actions such as adding labels, sending custom notifications ir setting page level restrictions in response to workflow events

Actions are [macros](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650151673) that are added to a [workflow event trigger](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649563178). When the event is detected, the trigger performs the actions.

They are extremely useful because they enable the workflow to **automate common tasks**. For example

- [adding labels](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650217225)
- [sending emails](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649957056)
- [setting messages for users](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650153597)
- [synchronising content with another server](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649728423)

## Example

In this example, the [trigger](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649859133) listens for the `pagecreated` event (only available in [space mode](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649531846)) and then performs the [set-message](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650153597) action.

```plaintext
{workflow:name=Action macros}
  {state:Test}
  {state}
  {trigger:pagecreated}
     {set-message}This is a new page created by @creator@{set-message}
  {trigger}
{workflow}
```

## Value references

Most actions support [Value References](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694302), such as `@creator@` in the example above.

These are named placeholders for information stored somewhere else, and they allow your actions to respond dynamically to the current workflow and content state.

## Notifications

Certain actions will trigger notifications.

> ℹ️ For more details, see the macro documentation page from the list below.

## Macros

Action macros must be placed inside the *macro body* of a **[trigger macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649859133)**.

> Macro (contentbylabel)

## Events

Certain actions will generate additional events.

> ℹ️ For more details, see the macro documentation pages above.

## App configuration

Certain macros will be affected by application settings.

> ℹ️ For more details, see the macro documentation pages above.

## Examples

These examples utilize a range of different actions workflow triggers.

> Macro (contentbylabel)

## See also

[Workflow Authoring Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/648611901)

- [Events](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649759655)
- [Triggers](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649563178)
- [Notifications](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649957056)
- [Value References](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694302)