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

## Overview

[v2.1.0 or later]

Pages and blog posts automatically update their data for the Comala Document Approval [report tools](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/649823076) and [report macros](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/649560338). These include

- [My Document Actions Profile](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/649789865)
- [Document Report - space sidebar](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/650149932)
- [Document Approvals Report](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/650149932)
- [Document States Report Macro](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/649528122)
- [Document Approvals Report Macro](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/742326668)
- [Document Tasks Report Macro](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=cdals&title=Document%20Tasks%20Report%20Macro&linkCreation=true&fromPageId=649659081) [v2.2.0+]

However, sometimes the data is not updated due to unexpected errors or a lack of edit permissions by the user that triggered the update.

In those cases, the data for the reports can be manually populated by running a space-level job using the **Refresh Data **screen in the [space tools Document Approval dashboard](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/649691453).

![cdadc_spacetools_datrefresh_doctasks_added.png](media://502945d2-654c-4838-beb3-dfc671690c0f)

> 📝 This option complements the option to run the space-level properties through the URL.

## When would I want to use this?

The data refresh option is 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 Approval reports and report macros.

## Running the space population

In space tools Document Approval dashboard

- choose **Refresh Data** dashboard
- choose the **Refresh Data** button option

> ⚠️ Before running the space properties population job, all workflows must be enabled or the existing data of pages and blog posts without a current applied approval workflow is deleted.

## Impersonation group for Refresh Data

[v2.3.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/CDALS/pages/649822586) (from v2.3.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.