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


## Overview

> Macro (excerpt)
> 
> Display recent page activity on a page.

The **Page Activity Macro** is used to display the activity report on a page. It's great for displaying recent activity in a page header or footer.

![pageactivitymacro_onpage_workflowwithfinalstate.png](media://11b4adb0-088c-46fc-8087-8f3f7e89d198)

## Permissions and report visibility

**All users can see the report** when the macro is added

- **On a page without a workflow**, all the page activity is displayed, but all the state indicator circles are grey (confused or unconfirmed workflow state), as no workflow is applied

![pageactivitymacro_noactiveworkflowonpage.png](media://ca46e79d-2414-4cc2-b9ec-28099aebf0e3)

- **On a page with an unrestricted workflow **(which does not define a `final=true` state), all the page activity is displayed

![pageactivitymacro_onpage_unrestrictedworkflow_nofinalstate.png](media://a849e315-1ff1-4e79-b437-96ac58d18da3)

When a workflow includes a **final state**, the user’s Confluence permissions affect what is displayed in the rendered report.

When the macro is added on a page with an applied workflow with a state defined as the **final state** ( `final=true` state parameter)

- Users with **edit** or **admin** permissions see the full report

![pageactivitymacro_onpage_fullreport_editpermission.png](media://1afcbbe1-46f0-429f-9c66-26602a5ff9f0)

- View-only users only see entries up to the point at which the most recent published (`final=true`) state was *entered*

![pageactivitymacro_reporttolastfinalstateonly_viewonlyuser.png](media://4816396b-c00a-45e9-91eb-a987eafa3317)

> 📝 If the page has not yet reached the final state, view-only users cannot view the page or the report.

## Adding the report

To add the report to a page:

In the page editor

- choose **Insert **> Macro (inline-media-image)

**→ Other Macros → All → Page Activity** or type **/page …**

![cdmdc_insertpageactivitymacro.png](media://253d4ffd-6499-44cd-b6a0-e8158be736fc)

- Customise the report to your requirements
- Choose **Insert**
- Here's how the macro looks on your page:

![page activity macro on a page with workflow applied](media://e194e2ae-b779-4a00-b6d6-526716214252)

## Same-space publishing

If your workflow uses [same-space publishing](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649794062) - the workflow has a state that is defined as the **final state** - the page activity report only lists entries up to and including the most recently published version of content.

## Customising the report

You can customise the report with the following macro settings:

| Setting | Default | Notes |
| --- | --- | --- |
| **Max Entries** | *All entries* | The number of results to show |
| **Reverse order** | *No* | Check the box to reverse the order of the report |

> ℹ️ Other [report page macros](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649856031) can be added to a page to report on workflow states, approvals, tasks, or document actions in a space or on selected pages.

## Related pages

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