---
title: "Add a custom states workflow"
canonical: "https://support.appfire.com/space/CDML/649891941/Add%20a%20custom%20states%20workflow"
format: markdown
---
> Macro (aura-html)


## Overview

Use this feature to create and add a custom workflow when applying a page workflow to an individual page or blog post.

![image](media://b1d05928-8506-4d10-a92e-dec385b9f283)

You amend the existing state names and add additional states before adding the workflow to the page or blog post.

This feature is only available in [page mode](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649628831).

## Adding the workflow

To display the **Add Workflow** dialogue box.

- Choose **[Page Tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649856105)**** > ****[Add Workflow...](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649726655)**

![image](media://e8a0065e-cd91-45c9-b0b5-75c87951338b)

In the **Add workflow** dialog box:

![image](media://8e83dbb0-4351-45ce-8447-b79c1e7baab6)

To add a workflow in page mode:

- Select **Apply only to "pagename"**
- Choose **Next** to open the **Add workflow** picker

![image](media://6f588763-bcc9-4e5a-a5b1-6078e144aa05)

Choose **Workflow with custom states**

> ✅ iI's at the bottom of the scroll-down list.

## Defining states

Choose the **Workflow with custom states**. A box appears with two default [states](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649595551):

- **In Progress**
- **Approved**

![image](media://b1d05928-8506-4d10-a92e-dec385b9f283)

Using this box, these two states can be

- removed
- replaced by new states
- appended with additional states added

Enter the states you want, separated by commas.

> ✅ The order added is the order they are displayed in the workflow builder and the initial order of the states in the workflow. If required, you can change the order of the states later in the workflow builder or the markup editor.

Open the workflow builder:

- Choose **Apply & Customize**

![image](media://815e99e9-1f4a-44e9-a82c-940cdcbc12bf)

> ℹ️ The default workflow is unrestricted (state lozenges are blue) - there is no [final published state](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649794062) in the workflow.

In workflow builder, the custom states workflow can be edited before applying it to the page. This includes

- Renaming the workflow
- Adding states or editing state names
- Changing the order of the states in the workflow
- Adding approvals and transitions to states
- Defining a state as a final state
- Enabling read confirmations for the final state

To add and apply to the page:

- Choose **Save**
- **Exit**

You can view and test the new workflow on your page or blog post.

To make further changes, edit the workflow using the workflow builder or the markup editor.

![image](media://82751833-b682-4860-ac58-9e9d366a1301)

In workflow builder, administrators can save the new page workflow as a template stored at the space level or the global level with appropriate administrator permissions. This lets you share a workflow across spaces in your instance.

![image](media://ca8d2bfc-33f7-42a4-aee0-48d15de01877)

For help in creating a custom workflow, see: [Editing the workflow with the workflow builder](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649924594).

## Default markup

The markup for the custom states workflow is shown below. It includes just the [state macros](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649531575) for the states you listed.

An example is shown below.

```plaintext
{workflow:name=Custom States Workflow}
    {state:In progress|taskable=true}
    {state}
    {state:Approved|taskable=true}
    {state}
{workflow}
```

For more information about workflow macros and their markup, see: [Macros](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650151673).

## See also

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