Import Text File (.json)
Import Keeper JSON structured file format
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.
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
To create a .JSON file from your existing Keeper vault, click on your email > Settings > Export:

Open your Keeper Settings

Export to JSON
Click on Export Now and type in your Master Password (if requested) to export your records in JSON format.
Keeper Commander is a developer / Admin tool that has many capabilities for managing your vault and Enterprise account.
The command to export a vault in JSON format is demonstrated below:
$ keeper shell
_ __
| |/ /___ ___ _ __ ___ _ _
| ' </ -_) -_) '_ \/ -_) '_|
|_|\_\___\___| .__/\___|_|
|_|
password manager & digital vault
Enter password for [email protected]
Password:
Logging in...
Syncing...
Decrypted [318] record(s)
My Vault> export --format json my_export_file.json
Processing... please wait.
318 records exported
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)
{
"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",
"login": "[email protected]",
"password": "123123123123",
"login_url": "https://facebook.com",
"notes": "This is our corporate shared record.",
"custom_fields": {
"Facebook Application ID":"ABC12345",
"TFC:Keeper":"otpauth://totp/Amazon:[email protected]?secret=JBSWY3DPEHPK3PXP&issuer=Amazon&algorithm=SHA1&digits=6&period=30"
},
"folders": [
{
"folder": "Social Media"
},
{
"shared_folder": "Shared Social",
"can_edit": false,
"can_share": false
}
]
}
]
}
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": "[email protected]",
"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": "<receipient 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": "[email protected]",
"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": "[email protected]",
"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": "[email protected]",
"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",
"TFC:Keeper":"otpauth://totp/Amazon:[email protected]?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
}
]
}
]
}