> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-platform/2023-2/configuration-manager/golden-configurations/manage/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Manage Golden Configurations

> Import, export, overwrite, and rename Golden Configurations

## Import a configuration

When importing a configuration, certain characteristics and behaviors occur if you do not pass in an extra property with each tree. These include:

* If the name is a duplicate, a unique index is used, such as `GC Name (1)`
* If the name is not a duplicate, then the original name is used in the export, such as `GC Name`
* Devices are not imported
* Task instances are imported

To import a Golden Configuration:

#### Navigate to Configuration Manager

Navigate to **Configuration Manager** under **Operation** on the main Itential Platform page.

#### Open Collection dialog

Select the **Search** icon (top toolbar) to display the **Collection** dialog.

#### Select Golden Configurations tab

Select the **Golden Configurations** tab.

ForItential Platform 2023.1 andItential Platform 2023.2 only.

#### Import file

Click the **Import** icon in the upper-left of the **Collection** dialog to open your file manager.

#### Select files

Locate and select the Golden Configurations that you want to import (represented as JSON files).

#### Confirm import

Confirm you want to import the file. A notification banner displays in the upper-right upon successful file import.

If the file is a duplicate, an import dialog will open and prompt you to [overwrite](#overwrite-golden-configs) the existing version or [rename](#rename-a-golden-configuration) it.

## Export a configuration

Use the following steps to export a configuration:

#### Open Configuration Manager

Log in to Itential Platform to open the home page and click **Configuration Manager** under **Operation** in the left navigation menu to open the application.

#### Open Collection dialog

Select the **Search** icon (top toolbar) in **Configuration Manager** to display the **Collection** dialog.

#### View Golden Configurations

Select the **Golden Configurations** tab from the **Collection** window to display all the card options.

![](/_fern-img/c278eca83d2a159602865d46ea52c867845df14cde44a4418b4e740a17f47099.webp)

#### Select and export

Select the checkbox at the bottom of each Golden Configuration you want to export and then click the **Export** icon (upper-left).

![](/_fern-img/61fa75159eaaf9862dfd7c71677c2505e49d53aeaa718a32a18458b551af9fc6.webp)

#### Confirm export

A message box appears asking you to confirm the export of the selected configurations. Click **Okay**.

![](/_fern-img/f7595867acb9e150067e84f9cd99f46041b035e69a1f74f2979b9e96a9a3df9e.webp)

#### Download file

The output file format is JSON. A download of the export file is shown in your browser. Once the download is complete, locate the export file in the downloads folder and perform an import.

![](/_fern-img/09c9d39c6ea73127a322fb1ffec1b87be7fd4aaac1c8f298d7d6c1660eea51ec.webp)

## Overwrite Golden Configs

When overwriting Golden Configurations, certain behaviors occur if you pass the `overWrite: true` property with each tree. These behaviors are as follows:

* The entire Golden Configuration is replaced except for devices and task instances
* Versions in the current Golden Configuration that do not exist in the imported Golden Configuration are deleted
* Versions in the imported Golden Configuration that exist but are not available in the current Golden Configuration are added

To overwrite a Golden Configuration:

#### Navigate to Configuration Manager

Navigate to **Configuration Manager** under **Operation** on the main Itential Platform page.

#### Open Collection dialog

Select the **Search** icon (top toolbar) to display the **Collection** dialog.

#### Select Golden Configurations tab

Select the **Golden Configurations** tab.

#### Import file

Click the **Import** icon in the upper-left of the **Collection** dialog to open your file manager.

#### Select file to overwrite

Locate and select the primary file that you want to overwrite with a secondary file of the same name.

* **Cisco 3650 - User FW** was imported as a primary file
* **Cisco 3650 - User FW** in the Downloads folder is the secondary file

![](/_fern-img/3b13f284722f889cddcd1cdc280219d504c1965c008c394644be6a7a818e6c98.webp)

#### Confirm overwrite

Click **Open**. A warning message appears indicating the primary file already exists.

![](/_fern-img/c662fe55b1813fa28f721b83a08930aa9b70dbf8ea533e57a7d749af6ed4106c.webp)

#### Complete overwrite

Click **Overwrite**. The primary file is overwritten. A success banner appears in the upper-right of the **Collections** window showing the overwritten file.

![](/_fern-img/fd68e2bf70c2fadd16c192bc00fb8ab3e5e60d067dbe2e7568bd479fc615f730.webp)

## Rename a Golden Configuration

When renaming Golden Configurations, certain behaviors occur if you pass the `newName": "some gc name"` property. These behaviors are as follows:

* The Golden Configuration is imported with a new name
* If that new name already exists, the new name is indexed as `New GC Name (1)`
* Devices are not imported
* Task instances are imported

To rename a Golden Configuration:

#### Navigate to Configuration Manager

Navigate to **Configuration Manager** under **Operation** on the home page.

#### Open Collection dialog

Select the **Search** icon (top toolbar) to display the **Collection** dialog.

#### Select Golden Configurations tab

Select the **Golden Configurations** tab.

#### Import file

Click the **Import** icon in the upper-left of the **Collection** dialog to open your file manager.

![](/_fern-img/eb4964890cf8351a89ef05edb67c67fcc33f60281cde910202c122b813587c13.webp)

#### Select file to rename

Select the Golden Configuration that you want to rename. In the example, JSON is the file to rename.

![](/_fern-img/e82201d7c3b7640bd999224f133f409f0fa57bccb1bc459c8a112c6af5ff89d5.webp)

#### Open warning dialog

Click **Open**. A warning message appears indicating the file already exists.

![](/_fern-img/4e5ae3b293adcb59814a3298cfc6c75ec942b9d040186959982e99e01190d762.webp)

#### Rename file

Rename the file name directly in the error message by clicking on the name (for example, **JSON** to **JSON Copy**). Notice that the error message and the **Overwrite** button changes to **Rename** instead.

![](/_fern-img/6ff05c5ce71240a00b7386bb1933478718889bf59d4ed960df8f4f47e32c5fa3.webp)

#### Complete rename

Click **Rename**. A success banner appears and the original **JSON** and the newly named **JSON Copy** file are displayed in the Collections window.

![](/_fern-img/fd68e2bf70c2fadd16c192bc00fb8ab3e5e60d067dbe2e7568bd479fc615f730.webp)

## Use the import API in Golden Configuration

This section provides backend developer information for importing, overwriting, and renaming Golden Configurations. Here are the parameters for calling the API:

```json
{
    "trees": [
        {
            "data": [{treeVersion1}, {treeVersion2}],
            "overwrite": true
        },
        {
            "data": [{treeVersion1}, {treeVersion2}],
            "newName": "New GC Name"
        },
        {
            "data": [{treeVersion1}, {treeVersion2}]
        }
    ],
    "options": {}
}
```

Each element in the `trees` array represents a Golden Configuration. Within each Golden Configuration, the data array represents each version that belongs to a Golden Configuration. For example, if a Golden Configuration has three versions, then the `data` array is going to have three objects inside of it for each version. Essentially, the payload is saying to import three Golden Configurations and each of those three Golden Configurations has two versions each.

To import a Golden Configuration, you can just pass in the import data and nothing else. It will:

* Either import the tree normally, assuming it's not a duplicate
* Index the name if it is a duplicate in which a tree name already exists (for example, if a tree called `IOS Tree` already exists then it will import as `IOS Tree (1)`)

### Overwrite property

To overwrite for a Golden Configuration, you have to pass the `overwrite: true` property.

### Renaming property

To rename a Golden Configuration, you have to pass in the `newName` property.

> Import, export, overwrite, and rename Golden Configurations