> For the complete documentation index, see [llms.txt](https://docs.ins-pi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ins-pi.com/designer/get-the-app/migrate.md).

# Migrate

This guide explains how to migrate Designer's configuration and diagrams with metadata from one ServiceNow instance to another using XML export and import.

## How to Migrate Designer's Configuration and Diagrams Between Instances

Designer is built on several ServiceNow tables. If you have made any changes to their configuration, you must migrate these changes via XML export.

### Designer Configuration Tables

The following tables must be migrated:

* Class Definitions (x\_inpgh\_des\_class\_definitions)
* Class Fields (x\_inpgh\_des\_class\_fields)
* Diagrams (x\_inpgh\_des\_diagrams)
* Filters (x\_inpgh\_des\_filters)
* Global Settings (x\_inpgh\_des\_global\_settings)
* Indicators (x\_inpgh\_des\_indicators)
* Indicator Breakdown (x\_inpgh\_des\_indicator\_breakdown)
* Relationship Definitions (x\_inpgh\_des\_relationship\_definitions)
* Relationship Fields (x\_inpgh\_des\_relationship\_fields)
* Shapes (x\_inpgh\_des\_shapes)
* Shape Libraries (x\_inpgh\_des\_shape\_libraries)
* Templates (x\_inpgh\_des\_templates)
* Cross-scope privileges (sys\_scope\_privilege)

### Additional ServiceNow Tables to Consider

Designer is built on the following ServiceNow tables. Migrate these if you have made any changes to their configuration:

* Images (db\_image)
* Relationship Types (cmdb\_rel\_type)
* Suggested Relationships (cmdb\_rel\_type\_suggest)

### Field Extensions, Dashboards, and Workflows

If you have changed Designer's configuration, migrate these via UpdateSet:

* Field extensions (captured via UpdateSet)
* Dashboards
* Reports
* Workflows

## Migrate Diagrams Between Instances

### Export Configuration from the Source Instance

To export diagrams plus metadata from an existing instance:

1. In the ServiceNow navigator, type **'x\_inpgh\_des\_diagrams.list'** and press Enter
2. Select the diagrams you wish to export, or select the all checkbox to export all diagrams
3. Right-click on any column heading and scroll down to select **Export > XML**
4. ServiceNow will prepare an XML file containing all your diagrams and their metadata. Once ready, select **Download**

### Import Configuration to the Target Instance

To import the XML file to a new instance:

1. In the ServiceNow navigator, type **'x\_inpgh\_des\_diagrams.list'** and press Enter
2. Right-click any column header and select **Import XML** from the dropdown menu
3. On the Import XML page, select **Browse**, locate your XML file, and select **Upload**
4. Once the upload is complete, your diagrams will be available in the new instance


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.ins-pi.com/designer/get-the-app/migrate.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.