# Import/Export Keeper JSON

<figure><img src="https://914511346-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSGVtOTYUIkVBoYtFvK%2Fuploads%2FM1Vide5ynu9LOd0Qgpg4%2FImport-Keeper-JSON.jpg?alt=media&#x26;token=ad379b62-89d3-4304-8020-fb16737f0f17" alt=""><figcaption></figcaption></figure>

Keeper supports importing a structured JSON file. You may use this, for example, if you have backed up a Keeper file from a different vault or if you are building a file from another data source. This is an advanced feature, typically used by Keeper Enterprise administrators or more technical customers. If that's not you, head over to [CSV import](https://docs.keeper.io/en/user-guides/import-records-1/import-a-.csv-file).

To begin, from the **Account Dropdown Menu**, click **Settings** **> Import > Import** (next to "Use Another Source"). From the dropdown menu, select **Keeper JSON**.

<figure><img src="https://914511346-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSGVtOTYUIkVBoYtFvK%2Fuploads%2FGKX3CoZI2679NYoyNTXm%2FScreenshot%202026-01-27%20at%2012.11.40%E2%80%AFPM.png?alt=media&#x26;token=499a5559-9118-4256-bd4e-9f82f167c243" alt=""><figcaption></figcaption></figure>

The JSON file can be created in several ways:

* Exporting .JSON file from the Keeper Vault
* Exporting .JSON from Keeper Commander SDK
* Creating your own custom file

Once your JSON file is properly formatted, drag-and-drop the file onto Keeper's "Drop a File Here" window or browse for the file on your computer.

{% hint style="info" %}
JSON files must be UTF-8 encoded to ensure that all symbols and characters are imported properly.
{% endhint %}

### Creating .JSON file from a Keeper Vault (Export)

To create a .JSON file from your existing Keeper Vault, from the **Account Dropdown Menu**, click **Settings > Export**.

Select **JSON** and click **Export**. If prompted, enter your Master Password and click **Export Now**.

![Export Keeper Records to JSON File](https://914511346-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSGVtOTYUIkVBoYtFvK%2Fuploads%2FYXnxKrRHqBTXOjkEzOfh%2FScreenshot%202026-01-27%20at%2012.12.33%E2%80%AFPM.png?alt=media\&token=5ea0e368-d6bb-426d-a2f3-df565fd728f7)

### Creating a JSON file from Keeper Commander

Keeper Commander is a developer / Admin tool that has many capabilities for managing your vault and Enterprise account.

Visit the Keeper Commander SDK repository here:\
<https://github.com/Keeper-Security/commander>

The command to export a vault in JSON format is demonstrated below:

```
$ keeper shell
  _  __  
 | |/ /___ ___ _ __  ___ _ _ 
 | ' </ -_) -_) '_ \/ -_) '_|
 |_|\_\___\___| .__/\___|_|
              |_|            

 password manager & digital vault

Enter password for demo@company.com
Password: 
Logging in...
Syncing...
Decrypted [318] record(s)

My Vault> export --format json my_export_file.json                                                                                         
Processing... please wait.
318 records exported
```

### Creating a Custom .JSON file for Import Into Keeper

When creating a custom JSON import file, Keeper supports an array of "records", "folders" and "shared\_folders". Several examples are included below that you can import into your vault for testing purposes.

Example JSON file: Records, Folders and Shared Folders

This file demonstrates several JSON import features including:

* Array of records
* Each record can have custom fields, notes and be added to folders
* Folders can be created as regular (private) or shared folders
* Records can also contain TOTP seeds (advanced feature, see Facebook entry in example below)

```
{
  "records": [
    {
      "title": "Dev Server 1",
      "login": "root",
      "password": "123123123",
      "login_url": "https://myserver.com",
      "notes": "These are some notes.",
      "custom_fields": {
        "Security Group": "Private"
      },
      "folders": [
        {
          "folder": "Private Folder 1"
        }
      ]
    },
    {
      "title": "Prod Server 1",
      "login": "root",
      "password": "kj949234723jhfs4jf7h",
      "login_url": "https://myprodserver.com",
      "notes": "These are some notes.",
      "custom_fields": {
        "Security Group": "Public",
        "IP Address": "12.45.67.8"
      },
      "folders": [
        {
          "folder": "Private Folder 2"
        },
        {
          "shared_folder": "My Shared Folder 1",
          "can_edit": true,
          "can_share": true
        }
      ]
    },
    {
      "title":"Google",
      "login": "testing",
      "password": "1234567890",
      "login_url": "https://google.com",
      "notes": "These are some notes.",
      "custom_fields": {
        "Favorite Food":"Cheetos"
      },
      "folders": [
        {
          "folder": "My Websites\\Online"
        }
      ]
    },
    {
      "title":"Facebook",
      "$type": "login",
      "login": "me@gmail.com",
      "password": "123123123123",
      "login_url": "https://facebook.com",
      "notes": "This is our corporate shared record.",
      "custom_fields": {
        "Facebook Application ID":"ABC12345",
        "$oneTimeCode":"otpauth://totp/Amazon:me@company.com?secret=JBSWY3DPEHPK3PXP&issuer=Amazon&algorithm=SHA1&digits=6&period=30"
      },
      "folders": [
        {
          "folder": "Social Media"
        },
        {
          "shared_folder": "Shared Social",
          "can_edit": false,
          "can_share": false
        }
      ]
    }
  ]
}

```

Here is a list of all possible field types (including custom fields):

<figure><img src="https://914511346-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSGVtOTYUIkVBoYtFvK%2Fuploads%2FDWjqagCoJ6qbOJmfavRi%2FWindowsTerminal_myNZzFQtif.png?alt=media&#x26;token=e58b37b5-910a-43c2-a07b-96076a25b20c" alt=""><figcaption><p>All Field Types</p></figcaption></figure>

Here are some record types (you may have more if you created custom record types, or less if you are restricting some record types):

<figure><img src="https://914511346-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSGVtOTYUIkVBoYtFvK%2Fuploads%2FMHXIXTWaoTC7Ha7y7ixC%2FWindowsTerminal_wOnQKBPAAK.png?alt=media&#x26;token=94c7f13e-0c77-4b59-b753-88d9b869316d" alt=""><figcaption><p>Record Types</p></figcaption></figure>

**Example JSON file: Shared Folders and Permissions - No Records**

The below JSON file demonstrates the ability to create a shared folder structure (without records) that has permissions configured.

Note: Example references to "UID", "Team UID", etc are placeholders that are specific to your vault.

```
{
  "shared_folders": [
    {
      "path": "My Shared Folder 1",
      "manage_users": true,
      "manage_records": true,
      "can_edit": true,
      "can_share": true,
      "permissions": [
        {
          "uid": "kVM96KGEoGxhskZoSTd_jw",
          "manage_users": true,
          "manage_records": true
        },
        {
          "name": "myusername@company.com",
          "manage_users": true,
          "manage_records": true
        }
      ]
    },
    {   
      "path": "Customer1\\My Shared Folder 2", 
      "manage_users": false,
      "manage_records": false,
      "can_edit": false,
      "can_share": false,
      "permissions": [
        {   
          "uid": "<TEAM UID HERE>",
          "manage_users": false,
          "manage_records": false
        },  
        {   
          "name": "<RECIPIENT EMAIL HERE>",
          "manage_users": true,
          "manage_records": true
        }   
      ]   
    },  
    {
      "path": "Customer2\\My Shared Folder 3",
      "manage_users": true,
      "manage_records": true,
      "can_edit": true,
      "can_share": true,
      "permissions": [
        {
          "uid": "<TEAM UID HERE>",
          "manage_users": true,
          "manage_records": true
        },
        {
          "name": "myusername@company.com",
          "manage_users": true,
          "manage_records": true
        }
      ]
    }
  ]
}
```

**Example JSON File: Both Private Records/Folders and Shared Records/Folders**

The below example JSON file combines several features - Shared Folders, Private Folders, Records and TOTP seeds.

Note: Example references to "UID", "Team UID", etc are placeholders that are specific to your vault.

```
{
  "shared_folders": [
    {
      "path": "My Customer 1",
      "manage_users": true,
      "manage_records": true,
      "can_edit": true,
      "can_share": true,
      "permissions": [
        {
          "uid": "kVM96KGEoGxhskZoSTd_jw",
          "manage_users": true,
          "manage_records": true
        },
        {
          "name": "user@mycompany.com",
          "manage_users": true,
          "manage_records": true
        }
      ]
    },
    {   
      "path": "Testing\\My Customer 2", 
      "manage_users": true,
      "manage_records": true,
      "can_edit": true,
      "can_share": true,
      "permissions": [
        {   
          "uid": "ih1CggiQ-3ENXcn4G0sl-g",
          "manage_users": true,
          "manage_records": true
        },  
        {   
          "name": "user@mycompany.com",
          "manage_users": true,
          "manage_records": true
        }   
      ]   
    }
  ],
  "records": [
    {
      "title": "Bank Account 1",
      "login": "customer1234",
      "password": "4813fJDHF4239fdk",
      "login_url": "https://chase.com",
      "notes": "These are some notes.",
      "custom_fields": {
        "Account Number": "123-456-789"
      },
      "folders": [
        {
          "folder": "Optional Private Folder 1"
        }
      ]
    },
    {
      "title": "Bank Account 2",
      "login": "mybankusername",
      "password": "w4k4k193f$^&@#*%2",
      "login_url": "https://amex.com",
      "notes": "Some great information here.",
      "custom_fields": {
        "Security Group": "Public",
        "IP Address": "12.45.67.8",
        "$oneTimeCode":"otpauth://totp/Amazon:me@company.com?secret=JBSWY3DPEHPK3PXP&issuer=Amazon&algorithm=SHA1&digits=6&period=30"
      },
      "folders": [
        {
          "folder": "Optional Private Folder 1"
        },
        {
          "shared_folder": "My Customer 1",
          "can_edit": true,
          "can_share": true
        }
      ]
    }
  ]
}
```