Skip to content

Importing Passwords

Overview

Importing is the counterpart to exporting, but it comes with its own set of considerations. The goal is to let you bring your existing passwords into Passwords safely, without opening the door to bulk‑leak risks or silent data loss. That’s why the import process is designed around small, deliberate steps rather than large automated migrations.

You can import a single password directly, or combine multiple individually exported entries into a single JSON file if you want to bring in more than one password at once. This gives you flexibility without compromising security.

How to import passwords

  1. Select a category: Select the category you want to import passwords into.
  2. Open the import dialog: Right‑click the category and choose “Import…” from the context menu.
  3. Choose your JSON file: In the file picker, select the JSON file containing your exported passwords and confirm.
  4. Review and finish: Passwords will import the entries into the selected category. Review them to make sure everything looks correct.

Example JSON

Below is an example JSON file that shows how you can combine multiple exported passwords into a single importable file, making it easier to bring several entries into Passwords at once.

[
  {
    "credentials": [
      {
        "length": 6,
        "password": "MySecurePass123",
        "secretOptCode": "987654",
        "username": "alice_account"
      }
    ],
    "description": "Alice's online shopping account",
    "notes": [
      { "content": "Use this account for grocery orders" },
      { "content": "Two-factor enabled" }
    ],
    "private_name": "Shopping - Alice",
    "url": "https://shop.example.com"
  },
  {
    "credentials": [
      {
        "length": 6,
        "password": "BobSecret42",
        "secretOptCode": "",
        "username": "bob_account"
      },
      {
        "length": 6,
        "password": "BobAdmin!Secure99",
        "secretOptCode": "445566",
        "username": "bob_admin"
      }
    ],
    "description": "Bob's test account with both standard and admin credentials",
    "notes": [
      { "content": "Standard + admin roles for testing" }
    ],
    "private_name": "Test Account - Bob",
    "url": "https://test.example.org"
  },
  {
    "credentials": [
      {
        "length": 6,
        "password": "SuperStrong!Pass1234",
        "secretOptCode": "112233",
        "username": "charlie_admin"
      }
    ],
    "description": "Charlie’s admin login",
    "notes": [
      { "content": "Admin privileges" },
      { "content": "Rotate password every 90 days" }
    ],
    "private_name": "Admin - Charlie",
    "url": "https://admin.example.net"
  }
]