Import & Export Guide

This guide shows you how to migrate your passwords to and from CoraleVault. Whether you’re switching from another password manager or creating backups, we’ve got you covered.

Time required: 5-15 minutes (depending on number of passwords)

Quick Navigation

• Exporting from CoraleVault
• Importing into CoraleVault
• From Chrome/Edge
• From Firefox
• From 1Password
• From LastPass
• From Bitwarden
• From KeePass
• Troubleshooting

Exporting from CoraleVault

Export to CSV

Best for: Backup, migrating to another manager, spreadsheet viewing

1. Open your vault in CoraleVault
2. Click File → Export → Export to CSV
3. Choose save location
4. Enter your master password (for confirmation)
5. Click Export

Output format:

Title,Username,Password,URL,Notes,Group
Gmail,john@example.com,MyP@ssw0rd,https://mail.google.com,Primary email,Email
Facebook,john.doe,Fb123456!,https://facebook.com,,Social Media

Export to JSON

Best for: Backup with full metadata, re-importing to CoraleVault

1. Open your vault
2. Click File → Export → Export to JSON
3. Choose save location
4. Enter master password
5. Click Export

Output format:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

{
  "version": "2025.11.5",
  "entries": [
    {
      "title": "Gmail",
      "username": "john@example.com",
      "password": "MyP@ssw0rd",
      "url": "https://mail.google.com",
      "notes": "Primary email",
      "group": "Email",
      "created": "2025-01-15T10:30:00Z",
      "modified": "2025-03-20T14:45:00Z"
    }
  ]
}

⚠️ CRITICAL SECURITY WARNING

Exported files are NOT encrypted!

• ✅ Delete export file immediately after use
• ❌ Never email export files
• ❌ Never store exports in cloud storage
• ❌ Never leave exports on shared computers

To delete securely:

• Windows: Shift+Delete (bypasses Recycle Bin)
• macOS: Command+Option+Delete (empties Trash)
• Linux: shred -u filename.csv (secure deletion)

Importing into CoraleVault

Import CSV

1. Open CoraleVault
2. Click File → Import → Import from CSV
3. Select your CSV file
4. Review the preview
5. Click Import
6. Delete the CSV file immediately

Import JSON

1. Open CoraleVault
2. Click File → Import → Import from JSON
3. Select your JSON file
4. Review entries
5. Click Import
6. Delete the JSON file

Supported CSV Format

CoraleVault expects this CSV format:

Title,Username,Password,URL,Notes,Group
"Entry Title","username","password","https://example.com","optional notes","optional group"

Required columns:

• Title - Entry name
• Password - The password

Optional columns:

• Username - Login name/email
• URL - Website address
• Notes - Additional information
• Group - Category/folder

From Chrome / Edge

Chrome and Edge use the same password export format.

Step 1: Export from Chrome/Edge

Chrome:

1. Open Chrome
2. Go to chrome://password-manager/settings
3. Click Export passwords
4. Enter your Windows/macOS password
5. Save as chrome-passwords.csv

Edge:

1. Open Edge
2. Go to edge://settings/passwords
3. Click ⋯ (three dots) next to “Saved passwords”
4. Click Export passwords
5. Save as edge-passwords.csv

Step 2: Import into CoraleVault

1. Open CoraleVault
2. File → Import → Import from Chrome/Edge
3. Select the CSV file
4. Review passwords
5. Click Import
6. Delete CSV file immediately

Chrome/Edge CSV Format

name,url,username,password
Google,https://accounts.google.com,john@gmail.com,MyP@ssw0rd123
Facebook,https://www.facebook.com,john.doe,Fb123456!

From Firefox

Step 1: Export from Firefox

1. Open Firefox
2. Click ☰ (menu) → Passwords
3. Click ⋯ (three dots)
4. Click Export Passwords
5. Enter your Windows/macOS password
6. Save as firefox-passwords.csv

Step 2: Import into CoraleVault

1. Open CoraleVault
2. File → Import → Import from Firefox
3. Select CSV file
4. Review and import
5. Delete CSV file

Firefox CSV Format

url,username,password,httpRealm,formActionOrigin,guid,timeCreated,timeLastUsed,timePasswordChanged
"https://accounts.google.com","john@gmail.com","MyP@ssw0rd123",,,,1234567890,1234567890,1234567890

From 1Password

Step 1: Export from 1Password

Desktop App:

1. Open 1Password
2. Click File → Export → All Items
3. Choose format: CSV
4. Enter master password
5. Save as 1password-export.csv

1Password 8:

1. Click account name → Export
2. Choose 1Password Unencrypted format (.csv)
3. Authenticate
4. Save file

Step 2: Import into CoraleVault

1. Open CoraleVault
2. File → Import → Import from 1Password
3. Select CSV file
4. Map fields if needed
5. Import
6. Delete CSV immediately

1Password CSV Format

Title,Username,Password,URL,Notes,Type,Category
Gmail Account,john@gmail.com,MyP@ssw0rd,https://mail.google.com,Primary email,Login,Email

From LastPass

Step 1: Export from LastPass

1. Log in to LastPass (web or extension)
2. Click Advanced Options (account menu)
3. Select Export
4. Enter master password
5. Copy the export data (it appears in browser)
6. Paste into a text file and save as lastpass-export.csv

Alternative (Browser Extension):

1. Click LastPass icon
2. Account Options → Advanced → Export
3. Save as CSV

Step 2: Import into CoraleVault

1. Open CoraleVault
2. File → Import → Import from LastPass
3. Select CSV file
4. Review entries
5. Import
6. Securely delete CSV

LastPass CSV Format

url,username,password,extra,name,grouping,fav
https://mail.google.com,john@gmail.com,MyP@ssw0rd123,Notes here,Gmail,Email,0
https://facebook.com,john.doe,Fb123456!,,Facebook,Social,0

From Bitwarden

Step 1: Export from Bitwarden

Web Vault:

1. Log in to vault.bitwarden.com
2. Go to Tools → Export Vault
3. Choose format: JSON (recommended) or CSV
4. Enter master password
5. Click Export Vault
6. Save file

Desktop/Browser:

1. Click Settings ⚙️
2. Select Export Vault
3. Choose format (JSON or CSV)
4. Authenticate
5. Save file

Step 2: Import into CoraleVault

1. Open CoraleVault
2. File → Import → Import from Bitwarden
3. Select JSON or CSV file
4. Review entries
5. Import
6. Delete export file

Bitwarden JSON Format

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

{
  "encrypted": false,
  "items": [
    {
      "type": 1,
      "name": "Gmail",
      "login": {
        "username": "john@gmail.com",
        "password": "MyP@ssw0rd123",
        "uris": [{"uri": "https://mail.google.com"}]
      },
      "notes": "Primary email"
    }
  ]
}

From KeePass

Step 1: Export from KeePass

1. Open your KeePass database
2. Click File → Export
3. Choose format: KeePass CSV (1.x) or Generic CSV
4. Select destination
5. Click OK
6. Choose fields to export
7. Save file

Step 2: Import into CoraleVault

1. Open CoraleVault
2. File → Import → Import from KeePass
3. Select CSV file
4. Map fields if necessary
5. Import
6. Delete CSV

KeePass CSV Format

"Account","Login Name","Password","Web Site","Comments"
"Gmail","john@gmail.com","MyP@ssw0rd123","https://mail.google.com","Primary email"

Generic CSV Import

If your password manager isn’t listed above, you can use Generic CSV Import.

Required Format

Title,Username,Password,URL,Notes,Group
"Gmail","john@gmail.com","MyP@ssw0rd","https://mail.google.com","Notes","Email"

At minimum, you need:

• Title column
• Password column

All other columns are optional.

Steps

1. Export from your current manager as CSV
2. Open CSV in Excel/LibreOffice
3. Rename columns to match:
   • Title (or Name, Account)
   • Username (or Login, Email)
   • Password
   • URL (or Website)
   • Notes (or Comments)
   • Group (or Folder, Category)
4. Save as CSV (UTF-8)
5. Import into CoraleVault
6. Delete CSV

Tips for Successful Import

Before Importing

1. Backup your vault - If you already have entries in CoraleVault
2. Review export - Open CSV in text editor to check data
3. Check encoding - Must be UTF-8 (not ANSI)
4. Remove duplicates - If exporting from multiple sources

During Import

1. Preview first - Review entries before confirming
2. Check field mapping - Ensure columns match correctly
3. Organize groups - Assign appropriate categories
4. Verify passwords - Spot-check a few critical passwords

After Importing

1. Test a few passwords - Make sure they work
2. Organize - Move entries to appropriate groups
3. Update weak passwords - Use password generator
4. Delete export file - Securely!

Troubleshooting

Import Fails with “Invalid Format”

Problem: CSV doesn’t match expected format

Solutions:

1. Check encoding (must be UTF-8)
2. Ensure proper CSV structure (commas, quotes)
3. Try Generic CSV Import instead
4. Open in Excel, fix issues, re-save

Passwords with Commas Don’t Import Correctly

Problem: Commas in passwords break CSV format

Solution:

1. Ensure passwords are in quotes: "P@ss,word"
2. Or use JSON export instead (no comma issues)

Special Characters Display as Gibberish

Problem: Wrong text encoding

Solution:

1. Re-export as UTF-8
2. Open CSV in Notepad++
3. Encoding → Convert to UTF-8
4. Save and re-import

Import Creates Duplicate Entries

Problem: Importing multiple times

Solution:

1. Check for existing entries before importing
2. Use File → Remove Duplicates (if available)
3. Or manually delete duplicates

Some Entries Missing After Import

Problem: CSV has empty required fields

Solution:

1. Check CSV in text editor
2. Ensure all entries have at least Title and Password
3. Fill in missing required fields
4. Re-import

Security Best Practices

During Migration

1. Use secure device - Don’t export/import on shared computers
2. Lock your screen - When stepping away
3. Close unnecessary apps - Minimize exposure
4. Use wired connection - Avoid public Wi-Fi

After Migration

1. Delete all export files - Use secure deletion
2. Empty Recycle Bin/Trash
3. Change master passwords (both old and new managers)
4. Verify migration - Test critical passwords
5. Update emergency contacts - If you shared passwords

If Export File is Lost/Stolen

Immediately:

1. Change passwords for all important accounts
2. Enable 2FA where possible
3. Monitor accounts for suspicious activity
4. Consider freezing credit (if financial data included)

Bulk Operations

Updating Multiple Entries

After import, you might want to:

1. Assign groups - Select multiple → Set Group
2. Update URLs - Select multiple → Batch Edit
3. Generate new passwords - Select multiple → Generate All

Exporting Specific Groups

1. Filter by group
2. Select all visible entries
3. File → Export Selected
4. Choose format

Automation (Advanced)

For technical users who want to automate imports:

Command Line Import (Coming Soon)

1
2

# Future feature
coralevault import --format csv --file passwords.csv --vault myvault.vault

Scripting

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# Example: Convert custom format to CoraleVault CSV
import csv

# Read your custom format
with open('custom.txt') as f:
    entries = parse_custom_format(f)

# Write to CoraleVault CSV format
with open('corale-import.csv', 'w', newline='', encoding='utf-8') as f:
    writer = csv.writer(f)
    writer.writerow(['Title', 'Username', 'Password', 'URL', 'Notes', 'Group'])
    for entry in entries:
        writer.writerow([entry.title, entry.username, entry.password,
                        entry.url, entry.notes, entry.group])

Migration Checklist

Print this checklist when migrating:

• Backup current CoraleVault (if applicable)
• Export from old password manager
• Save export file in secure location
• Review export file for completeness
• Import into CoraleVault
• Verify critical passwords (bank, email, etc.)
• Test login on a few websites
• Organize entries into groups
• Update any weak passwords
• Delete export file securely
• Empty Recycle Bin/Trash
• Make backup of new CoraleVault file
• Store backup in multiple locations

Need Help?

• Import issues: Troubleshooting Guide
• Questions: FAQ
• Report bugs: GitHub Issues

Last updated: November 4, 2025 Current Version: 2025.11.5