---
title: "App data and global configuration"
canonical: "https://support.appfire.com/space/CMJ/198279999/App%20data%20and%20global%20configuration"
format: markdown
---
> Macro (aura-html)

## Introduction

As part of the *App Integrations* functionality, you can export and import the global configuration and app data of the apps on your system, integrating with Configuration Manager for Jira.

**Global configuration** means app data that is not related to projects, custom fields, or any other object (configuration element) in Jira. 

**App data** refers to any custom functionality of an app that extends standard Jira functions. For example, the “[listeners](https://docs.adaptavist.com/sr4js/latest/features/listeners)” and “[behaviors](https://scriptrunner.adaptavist.com/latest/jira/behaviours-overview.html)” in the [ScriptRunner](https://marketplace.atlassian.com/apps/6820/scriptrunner-for-jira?tab=overview) app are such functions. You can export and import app data between Jira instances with your snapshots if: 

- the app integrates with CMJ, **and**
- the app has the SPI [app data integration point](https://appfire.atlassian.net/wiki/spaces/CMJ/pages/302483216) implemented.

This feature extends the CMJ’s snapshot creation wizard.

![image](media://35b7661b-6fdd-466a-968f-da9864593c1e)

## How to migrate global configuration and app data?

### System snapshots

> ℹ️ When creating system snapshots, you can **only** choose whether to include the available global configuration and apps' data of all integrated apps on your Jira system or not to include any apps' data at all.

**To export global configuration and app data of all integrated apps:**

1. Log in as a user with the **Jira System Administrators **[global permission](https://support.atlassian.com/jira-cloud-administration/docs/manage-global-permissions/).
2. Choose the **cog icon **at the top right of the screen, then from the menu, choose **Configuration Manager.**
3. From the menu on the left, choose the **Create Snapshot **option.
4. Select the **System Configuration** button in the wizard and enter a name for the Snapshot. Optionally enter a description.
5. Enable the *Include Global App Data *checkbox*. *  
The snapshot will include apps' global configuration and app data of all installed apps integrating with CMJ.

![image](media://623e9ccd-a870-4784-9707-48f4a3409ec6)

### Project snapshots

> ℹ️ When creating a project snapshot, you can select the apps you want to export. Additionally, you can exclude any integrated app’s global configuration and app data.

**To export global configuration and app data of integrated apps:**

1. Log in as a user with the **Jira System Administrators **[global permission](https://support.atlassian.com/jira-cloud-administration/docs/manage-global-permissions/).
2. Choose the **cog icon **at the top right of the screen, then from the menu, choose **Configuration Manager.**
3. From the menu on the left, choose the **Create Snapshot **option.
4. Select the **Project Configuration** button and enter a name for the snapshot.
5. Select as many projects as you need to include in the snapshot. Optionally enter a description.
6. Click **Next **until you reach the **Select Apps** page in the wizard.
7. Check the box next to an app, and this will include its global configuration and app data in the snapshot.
8. To make a more precise selection, you can expand each app and check the boxes individually next to the global configuration and app data you want to include in the snapshot.
9. Click the **Create **button.

> ℹ️ **Why do you see a different organization of the app data for different apps?**
> ℹ️ 
> ℹ️ The organization of the app data depends entirely on the app vendor’s approach during the integration with CMJ. For some apps, you may be able to drill down a comprehensive list of data categories containing another level of data objects. For other apps, you may find only a flat list of data objects or categories.

![image](media://f7a621f9-31e1-4831-99a4-4547dc0d6720)

### Import global configuration and app data 

**To import global configuration and apps' data:**

1. From the menu on the left, choose the **Deploy **option.
2. Choose the snapshot that includes global configuration and app data. Read the [documentation](https://appfire.atlassian.net/wiki/spaces/CMJ/pages/197857038) to learn more about configuration snapshot deployment.
3. On the **Analyze **phase, navigate to the **Apps **tab.
4. You will see messages informing you about the specific event - whether Configuration Manager for Jira adds, changes, or deletes global configuration and app data.
5. Click **Next **and finish the deployment.

> ⚠️ **Prerequisites for snapshot import**  
> ⚠️ Before importing a snapshot, make sure you have all necessary apps installed on your target Jira instance. The deployment will stop if an app’s data is included in the snapshot but the app is not present on the target instance.