---
title: "Read confirmation"
canonical: "https://support.appfire.com/space/CDML/649791545/Read%20confirmation"
format: markdown
---
> Macro (aura-html)


## Overview

A [read confirmation function](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649693103) can be added to <span style="color: #172b4d">pages and blog posts. This feature allows workflow authors to request that users confirm that they have read certain content.</span>

<span style="color: #172b4d">A read confirmation can be added to content as either:</span>

- <span style="color: #172b4d">a </span><span style="color: #172b4d">[standalone read confirmation](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649827501)</span><span style="color: #172b4d"> on a page without a workflow.</span>
- <span style="color: #172b4d">a </span><span style="color: #172b4d">[workflow read confirmation](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650218328)</span><span style="color: #172b4d"> for the final state of a workflow.</span>

By default, users assigned as readers to a read confirmation will receive notifications for read confirmation events. However, read confirmation notifications can be disabled in [global administration](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649530054) for the instance or [space administration](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650119000) for a space.

## Standalone read confirmation

A <span style="color: #172b4d">[standalone read confirmation](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649827501)</span> can be added to a page or blog post using the page action menu.

![image](media://eda6cd73-5158-442c-9792-2fbea79ebaef)

<span style="color: #172b4d">The read confirmation status icon (double-tick icon) is then displayed in the page header.</span>

![image](media://816c1402-ddfd-4548-8f49-8039343a7fd5)

## Workflow read confirmation

When a reviewer makes an approval decision, and the workflow transitions to the final state, a <span style="color: #172b4d">[workflow read confirmation](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650218328)</span> (if [enabled for the workflow](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649695072)) can be added to the final state (or published) content. 

![cdm_readcon_workflow_rc_onpage.png](media://a98d4ad7-1edd-4030-863b-225d68bf542c)

The read confirmation byline breadcrumb is also added to the page footer and contextualized for the current user. If you have been assigned to read a page, the **Confirm** option is displayed at the bottom of the page.  

![image](media://3734f4a4-38d6-46d7-a5e5-9bb15a40a74a)

When viewing the page, you can choose **Confirm** to record that you have read the content.

## Assigning users as readers

One or more users can be [assigned to read a specific page or blog post](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650252218) and requested to confirm reading the content. 

Users can be assigned as readers using the [read confirmation popup](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650218477) accessed through the read confirmation status icon on the page

![image](media://699b7edb-a91f-43c8-83bb-016c07cda0ca)

You can use the **Edit readers** ellipsis menu option to search for users and [add or remove users as readers](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650252403).

![image](media://eece6bbd-2c67-4107-8731-127318aa95a9)

You can search and select one or more users to add as a reader.

![image](media://632501dc-3613-4604-acf4-17d459acc31e)

## Preassigning readers using an applied workflow

In a workflow, an editor or space administrator can edit the [workflow read confirmation configuration](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649695072) to add users as readers when a read confirmation is added to the final state. 

The [read confirmation status](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649629545) for the content is pending until all assigned users have confirmed. Only the read confirmation for the most recent version that the user confirmed is displayed.

![image](media://63a91318-2378-4c69-b605-69623586a5f1)

<span style="color: #172b4d">A </span><span style="color: #172b4d">[due date](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649860011)</span><span style="color: #172b4d"> can be added for all assigned readers to complete a read confirmation. The dialog box displays</span> the remaining time until the due date.

![image](media://a0a4c0cd-ee22-42d4-90c0-88491bb84857)

## Reporting with an applied workflow

When a workflow is applied to the page:

- read confirmations that all readers have confirmed are recorded in the [document activity report](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650154220) for the page

![cdmdc_documentactivityreport_readconfirmation_allconfirmedbyassignees.png](media://23e7a997-cc5d-4327-8328-d5d1ea564bb6)

- the current [read confirmation status](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649629545) (**Pending**, **Confirmed,** or **Overdue**) is recorded in the [space document report](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650154220)

![cdmdc_documentreport_readconfirmation_status_pagebypage_withworkflowapplied.png](media://9c78f71e-096f-4799-81f1-1cbacffe0dda)

> 📝 The document report settings must have been configured by the space administrator to display the Read Confirmation entries.

## Working with read confirmations

See the following to learn more

|  |
| --- |
| **[User Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/648907144)** |
| > Macro (children) |
| **[Workflow Authoring Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/648611901)** |
| - [Read Confirmations](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649693103)
- [Adding a read confirmation](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649761089)
- [Read confirmation assignments](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650252218)
- [User read confirmation](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649794401)
- [Enable and edit a read confirmation using workflow builder](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649956579) |
| **[Reporting Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649070833)** |
| - [Reporting read confirmations](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650154220) |