---
title: "Data Refresh - space tools"
canonical: "https://support.appfire.com/space/CDML/649859819/Data%20Refresh%20-%20space%20tools"
format: markdown
---
> Macro (aura-html)


|  |  |  |  |  |  |  |  |  |  |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| [Document Management](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649827041) | [Configuration](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649956239) | [Parameters](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649726501) | [Notifications](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650119000) | [Import](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649627884) | [Clear History](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649791892) | [Support](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650250352) | [Audit Log](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649530343) | **Data Refresh** | [Export Metadata](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=awpd&title=Attach%20Activity%20and%20Metadata%20-%20Space%20Tools&linkCreation=true&fromPageId=617489410) |

## Overview

[v7.3.0+] 

Pages and blog posts automatically update their data for the following document management reports

- [My Document Actions Profile](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650152557)
- [Document Report - space sidebar](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649825673)
- [Document States Report Macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649562443)
- [Document Approvals Report Macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/741671547)
- [Document Tasks Report Macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/943194589) [v7.5.0+]

However, sometimes, the data is not updated if there are unexpected errors or the user who triggers the update lacks edit permissions. 

In those cases, the data in the space for the reports can be manually populated by running a space-level job using the **Refresh Data** screen in the space tools Document Management dashboard.

![cdmdc_datarafresh_spacetools__doctasksreport_added.png](media://dc25c09e-8e4b-4909-add9-7a020e2405dc)

> 📝 This option complements the option to run the space-level data refresh of page workflow properties through the URL.

> ℹ️ Use the Report Data Population tab for Comala Document Management v7.2.3 and earlier.

## When would I want to use this?

The data refresh option can be used to populate space properties data for the workflow properties for your pages and blog posts in a space if there are unexpected errors in Comala Document Management reports and report macros.

In addition to a whole space refresh of data, each workflow report and report macro (from v7.3.0) includes an option to **Refresh Data** for the report while viewing the report. 

![cdmdc_datarefreshsection_reports_reportmacros.png](media://39708850-d632-4dfd-ae25-231620c133a7)

> 📝 To display this in-report data refresh option, hold the pointer over the displayed data in the report.

## Running the space data refresh

In the space tools Document Management dashboard

- Choose the **Refresh Data** screen tab
- Choose the **Refresh Data** button

> ⚠️ Before running the space data refresh job, all workflows must be enabled, or the existing data of pages and blog posts will not be included in the report.

Pages with page-level restrictions might not have their data refreshed if the space administrator does not have edit permission for the page.

## Impersonation group for Refresh Data [v7.6.1+] 

To ensure the data refresh process has access to restricted pages, a global administrator can set a Confluence user group to impersonate a Confluence administrator when the data refresh process is executed in a space.

The **Impersonation group for the Refresh Data** option is available in the app [global configuration](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649889951) (from v7.6.1 Data Center). If impersonation is required, it must be set for the instance by the global administrator before the data refresh process is run.