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


## Overview

> Macro (excerpt)
> 
> Remove a label from the content

Use the `remove-label` macro to remove a content label – either the current page or blog post, or the immediate child pages.

## Where to use it?

Optional.

One or more `remove-label` macros can be put in a [trigger](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649859133)**[ ](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649859133)**[macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649859133).

## Parameters

| Parameter | Required | Default | Notes |
| --- | --- | --- | --- |
| *unnamed first parameter*  
or `label` | :check_mark: |  | Name of label to remove:<br>- The name can use any character set supported by your Confluence server – except some [reserved characters](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649859070).
- Supports [Value References](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694302) (v4.4.1+) |
| `children` |  | `false` | What should the label be removed from?<br>- `false` – the page or blog post itself (default)<br>- `true` – all immediate children of the page, but not the page itself<sup>**†**</sup> |
| <sup>**†**</sup>** **Only works for pages, not blog posts. **Use with caution**! |

## Conditions

The following [conditions](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694110) are applicable to label events

- `haslabel`
- `parenthaslabel`

> 📝 The `stickylabels` parameter on a [workflow](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649662219) limits the users who can remove one or more defined labels on a page to those users with administrator permission. If the workflow includes a trigger action to remove a label defined by the `stickylabels` parameter, the label is only removed when the workflow event the trigger was listening for is actioned by a user with appropriate administrator permission.

## Events

The following [events](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649759655) are generated by this macro

- `labelremoved`

## Example

```plaintext
{workflow:Labelled}
   {state:Editing|submit=Review}
   {state}
   {state:Review|rejected=Editing|approved=Review}
      {approval:Review}
   {state}
   {trigger:pagerejected|approval=Review}
      {remove-label:being-reviewed}
   {trigger}
{workflow}
```

## All examples

> Macro (contentbylabel)

## Related pages

- [https://appfire.atlassian.net/wiki/spaces/CDML/pages/650217225](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650217225)
- [https://appfire.atlassian.net/wiki/spaces/CDML/pages/649563178](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649563178)
- [https://appfire.atlassian.net/wiki/spaces/CDML/pages/649759655](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649759655)
- [https://appfire.atlassian.net/wiki/spaces/CDML/pages/649858941](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649858941)