---
title: "State expiry date"
canonical: "https://support.appfire.com/space/CDML/649693610/State%20expiry%20date"
format: markdown
---
> Macro (aura-html)


## Overview

States can be given a **due date** (often referred to as an **expiry date**). If present, this is displayed next to a clock icon in the [state dialog box ](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649659846)(the workflow popup).

![image](media://2758ba21-c25a-49c0-9cd8-02d0af67d3ed)

> ℹ️ The example above shows that the content is in a **Rejected** workflow state that expires in **2** **days** from the present time.

The state dialog box (the workflow popup) only shows the destination state if there is also another possible transition from the state, such as a select transition.

![image](media://22680fe1-2735-4767-be86-ca2ab5db9028)

## Expiry icon colors

The **clock** icon displayed in the state dialog box (the workflow popup) changes color to indicate the current status of the **due date.**

| **Icon** | **Notes** |
| --- | --- |
| ![image](media://8073d4c4-9e0a-48d9-a99e-2f4cf413b2ea) | The state is not set to expire, but you can add an expiry date |
| ![image](media://ee5621de-c15c-4cef-9a36-db25c09bd227) | The state will expire in 3 or more days |
| ![image](media://78c5bd54-b11b-4a79-bc4a-620a7708ff15) | The state will expire in less than 3 days |
| ![image](media://1a6510c7-65a3-4471-8228-f8ad22a6fbca) | The state has expired |
| From **Comala Document Management v7.8.1**, a change in the user's timezone preference is reflected in the status dialog box, in-app reporting tools, and report macros. |

The period from the current day to the due date is displayed in the largest whole time period remaining - minutes, hours, days, months, or years. For example, if the expiration period is less than 30 days, the state dialog box (the workflow popup) displays the number of days from the current day to the due date.

![image](media://cb19fa9f-1976-4c64-83e1-d489412091d9)

If the due date is set is more than 30 days the workflow popup will display the period to the due date in whole months.

![image](media://00c12ec6-176f-4c44-a8b4-ecee5781d5db)

Roll over the due date in the state dialog box (the workflow popup) to view the specific due date.

If the due date is editable by the user, choose it in the workflow state dialog box (workflow popup) to open the [date and time picker](https://comalatech.jira.com/wiki/spaces/AWPD/pages/6428168373/State+expiry+date#Changing-the-date).

> ℹ️ If the due date parameter is set as a **Period, **the displayed due date defaults to the nearest whole time unit period. For example, setting a** Period** of 25 hours is displayed as 1 day.

## What happens when it expires?

It depends on the workflow as to what will actually happen

- the workflow might change to another state
- or someone gets an email notification
- or simply nothing

States can be left in an expired state if that's how the workflow is implemented, and this may often be the case if [reporting](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649070833) is used to handle expired states.

> 📝 When a state expires, it may take up to a minute for changes to be visible, and a page refresh is required.

## Changing the date

The expiry date is usually set in the workflow markup. However, some workflows let you change it or add it on the page.

To change the expiry due date in the workflow state dialog box (workflow popup):

- choose the **Clock** icon
- or choose **Set due date** from the menu

![image](media://3823fb32-ee93-442b-a855-55593e6eed85)

You can then specify the **due date** (the date on which the state is due to expire) using the **date and time picker**.

![image](media://84824873-7ef9-469d-8566-aa24ae37c86a)

## Metadata

Some workflows will provide alternate methods by which to set the expiry date. These include:

- [workflow setup](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650216852) – when first applying the workflow to a piece of content
- [Parameters - Space Tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649726501) – uses the parameter value set by a [space administrator](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650314379) at the space level
- other metadata – including integrations with third-party products, page properties, etc.

## See also

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

- [Task expiry date](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649661544)

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

- [Report on states](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650216427)

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

- [Expiry Dates](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649890606)
- [Notifications](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649957056)
- [States](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649595551)

| [‹ Back to Workflow Popup](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649659846) |
| --- |