---
title: "Global administration"
canonical: "https://support.appfire.com/space/CDALS/649822586/Global%20administration"
format: markdown
---
> Macro (aura-html)

Comala Document Approval global configuration options are found under the Confluence global administration console.

![image](media://d7d9a6f1-c3e9-4567-b463-e0d4fa2c064e)

From [Comala Document Approval v1.11](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/649691637), a global administrator can choose the [Document Activity Upgrade](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/649789715) option to run pre-upgrade data checks for spaces to use document activity for workflow events and activity in [Comala Document Approval 2 (Data Center Only)](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/648840516).

# Configuration Screen

Choose one of the **Edit** buttons on the screen to display the configuration options.

![cda_globalconfiguration_edit_view.png](media://055e3578-d48f-4c26-8961-97f33316690e)

| Setting | Options | Notes |
| --- | --- | --- |
| ## **Configuration**<br>For the visibility of approval activity and draft and final content |
| ### Approval Activity and Drafts Visibility<br>Who can see approval activity and unpublished drafts? | **Space Administrators and Page Editors** | **Recommended for most use cases.**<br>Unapproved drafts and activity reports will not be visible to users who would otherwise normally be able to view the content only. (Not edit) |
| **Anybody** | Anyone who could normally view the content will be able to view drafts and activity reports. |
| ### Page Update Reset Approval<br>If an approval (content review) is in progress, what effect does editing the content have? | **Reset** | Any existing Approve/Reject decisions will be reset. |
| **Ignore** | Existing Approve/Reject decisions will be retained. |
| ### Published View Macro Transform<br>Which version of content should the [{include}](https://confluence.atlassian.com/doc/include-page-macro-139514.html) and [{excerpt-include}](https://confluence.atlassian.com/doc/excerpt-include-macro-148067.html) macros show? | **Enabled** | **Recommended in most use cases.**<br>Use the approved version if available, otherwise use the latest version. |
| **Disabled** | Show the latest version content, regardless of the approved state version. |
| ### **Document Dashboard Actions Component**<br>Should the [Document Actions Report](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/649789865) be displayed for the current user on the Confluence dashboard? | **Enabled** | This shows for the current user, the document actions report for pending assigned approvals on the Confluence dashboard. |
| **Disabled** | Document actions report is not displayed on the Confluence dashboard. |
| ### Enable CDA Actions in Page Tools | ***Checkbox (Default: Checked)*** | When disabled (unchecked), app action options, such as **Add Approval**, are not displayed in the page tools menu. |
| ## **Usage Statistics** |
| ### Enable Usage Statistics | ***Checkbox (Default: Unchecked)*** | When enabled, anonymous usage statistics will be sent to Comalatech to help improve the product. |
| ## **User Onboarding** |
| ### Enable onboarding | ***Checkbox (Default: Checked)*** | When enabled (checked), introductory information and tips will be shown to new users: [User Onboarding](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/649822586/Global+administration#User-Onboarding). |
| ### Display top bar Link | ***Checkbox (Default: Checked)*** | When enabled (checked), a link to Onboarding isdisplayed in the Confluence top bar. |
| ## **Security**<br>Setting the spaces where page approvals can be added and applied |
| ### Space Approvals<br>Which spaces can have space wide approvals enabled. | ***List of spacekeys***<br>***Check buttons***<br>- ***Allowed***
- ***Restricted*** | A list of comma-separated space keys.<br>Leave empty for no spaces, or specify `ANY` to indicate all spaces.<br>If<br>- **Allowed** - when checked, space scope workflows can be added to content in the spaces listed
- **Restricted** - when checked, space-scope workflows cannot be added to content in the spaces listed |
| ### Page Approvals<br>Which spaces can use page-level approvals | ***List of spacekeys***<br>***Check buttons***<br>- ***Allowed***
- ***Restricted*** | A list of comma-separated space keys.<br>Leave empty for no spaces, or specify `ANY` to indicate all spaces.<br>If<br>- **Allowed** - when checked, page-level workflows can be added to content in the spaces listed
- **Restricted** - when checked, page-level workflows cannot be added to content in the spaces listed |
| ![image](media://d90adf0d-66ef-4dc1-a4dd-cc28799ded23) |
| ## Impersonation group for Refresh Data<br>This user group is used to impersonate a Confluence admin when running the refresh data process in a space. It lets a space administrator successfully [refresh the workflow data for a space](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/649659081), including pages with page-level edit restrictions.<br>Edit the settings to add a Confluence user group with global administrator permissions. |
| **Admin user group**<br>Select a Confluence administrators group to impersonate when space admins run the data refresh process | Default: **Not set**<br>Accepted value: Confluence user group<br>- requires a group with Confluence global administrator permission | When set, a user from the user group is used to impersonate a Confluence admin when running the refresh data process in a space.<br>This ensures the process has access to restricted pages in the space. |
| ![cdmdc_globalconfigruation_impersonatio groupfordatrefresh_witheditbutton.png](media://9b21effc-f736-487f-a7fe-8658e08a6cee) |

## Notifications Screen

![image](media://6f45a060-4501-48f9-a04b-e44138f0d930)

| Setting | Options | Notes |
| --- | --- | --- |
| ## **Workflow Notifications**<br>Notifications for given workflow events |
| ### Approval - Assignee | ***Checkbox*** | Send notification emails to approval assignees when they are assigned an approval on a page. |
| ### Read Confirmation | ***Checkbox*** | Send notification to read confirmation assignee(s) for all read confirmation events for a read confirmation added to a page |

## Upgrade Activity

[Comala Document Approval 2 ](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/648840516)is data center only and uses a n<span style="color: #172b4d">ew, improved capability called </span>**Document Activity** instead of the **Page Activity**.

- existing spaces with applied workflow (or workflow activity) will need their workflow data upgraded to use the capabilities of document activity
- new spaces created after installation of Comala Document Approval 2.0+ (and existing spaces without workflow activity) will automatically use document activity when a workflow is applied

Global administrators can undertake an upgrade check process using the **Document Activity Upgrade** screen options.

In the [Document Activity Upgrade](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/649789715) screen, choose one or more spaces to run upgrade checks prior to an upgrade to [Comala Document Approval 2 (Data Center Only)](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/648840516).

![image](media://840ff291-e832-4903-9f08-64a08c25bf89)

This upgrade check identifies any errors in the existing data prior to the upgrade and provides an estimate of the time for the upgrade on a space-by-space basis.

In Comala Document Approval 2.0, the console is used to run the upgrade and pre-upgrade checks together.

> ℹ️ Upgrading the data requires Comala Document Approval 2.0+ to be installed and **Read Only Mode **to be enabled in your data center instance.

## Related pages

- [https://appfire.atlassian.net/wiki/spaces/CDALS/pages/649789715](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/649789715)
- [https://appfire.atlassian.net/wiki/spaces/CDALS/pages/649756845](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/649756845)
- [https://appfire.atlassian.net/wiki/spaces/CDALS/pages/649691453](https://appfire.atlassian.net/wiki/spaces/CDALS/pages/649691453)