---
title: "description macro"
canonical: "https://support.appfire.com/space/CDML/649595915/description%20macro"
format: markdown
---
> Macro (aura-html)


## Overview

> Macro (excerpt)
> 
> Describe your workflow templates.

The `description` macro is used to define the description of your workflow template.

The description appears in the following places:

- **[Workflows - Global](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649530159)** – seen by [Confluence Admins](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650150846)
- **[Document Management - space tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649827041)** – seen by [Space Admins](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650314379)

Additionally, in [Page mode](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649628831):

- **[Add Workflow - page tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649726655)** – seen by [Users](https://appfire.atlassian.net/wiki/spaces/CDML/pages/648907144)
- **[Edit Workflow - page tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650119254)** – seen by [Users](https://appfire.atlassian.net/wiki/spaces/CDML/pages/648907144)

## Where to use it?

Optional, but recommended.

One `description` can be put in a [workflow macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649662219).

## Parameters

| **Parameter** | **Required** | **Default** | **Notes** |
| --- | --- | --- | --- |
| *macro body* | :check_mark: |  | The description:<br>- Plain text
- Can use any character set supported by your Confluence server – except some [reserved characters](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649859070). |

## Example

```plaintext
{workflow:name=Described Workflow}
   {description}
      This is my awesome workflow
   {description}
   {state:Example}
   {state}
{workflow}
```

## See also

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

- [Templates](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649628549)

[Administration Guides](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649233819):

- [Document Management - space tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649827041)
- [Page Workflows Templates - space tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649827962)
- [Workflows - Global](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649530159)

[User Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/648907144):

- [Add Workflow - page tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649726655)
- [Save as template](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650348103)