Import your 1Password data into Codebook

Import Using 1PUX

This feature is only supported on macOS, but you can the sync your data over to Codebook on your other systems after completing the import process.

Codebook will create an Entry record for each of the records in your 1Password export. Each Entry will be placed in a Category named after the record type in 1Password. For each field on your records, Codebook will create a Field object to hold its value on the Entry, and assign it a Label with corresponding behavior. If a matching Label doesn't exist already, Codebook will create it.

The content of any Secure Note will be added as a Note field on an Entry with a title matching the original note, and placed in a Category named Secure Notes.

Any Document (file storage) records will have an Entry created with a matching title, and the file imported as an Attachment. These are visible on an Entry's Attachments view. These Entries are placed in a Category named Documents.

Before You Begin

Caution: You are about to export your passwords into an unencrypted file! We recommend you temporarily disable any backup software you use to avoid creating a backup of the unencrypted file. Anybody with access to this file will be able to see your passwords and other secrets.

Step 1: Export your data from 1Password

1. Launch 1Password and sign in.
2. Click the File menu > Export and click on the name of the account you wish to Export.
3. The 1Password export dialog will appear. Enter your password at the top.
4. Click on the radio checkbox for 1PUX.
5. Click the Export Data button and save the 1PUX file to your computer.

Step 2: Import your data into Codebook

1. Launch Codebook on your Mac and sign in.
2. Click the File menu > Import > Import 1Password 1PUX....
3. In the open dialog that appears, choose the file you exported from 1Password.
4. After the import process completes, verify that the passwords you imported are present in the Codebook interface.

Step 3: Clean Up

1. Delete the unencrypted 1PUX export file from 1Password on your computer
2. If you had disabled your backup software, resume it now

Import Using CSV

This feature is only supported on macOS and Windows, but you can the sync your data over to Codebook on iOS and Android after completing the import process.

The 1Password CSV export only contains the records known as Login Items. Codebook will create an Entry record for each of the Login Items, including the username, password, and website for each. Each Entry will be placed in a Category named Logins.

Before You Begin

Caution: You are about to export your passwords into an unencrypted file! We recommend you temporarily disable any backup software you use to avoid creating a backup of the unencrypted file. Anybody with access to this file will be able to see your passwords and other secrets.

Step 1: Export your data from 1Password

1. Launch 1Password and sign in.
2. Click the File menu > Export and click on the name of the account you wish to Export.
3. The 1Password export dialog will appear. Enter your password at the top.
4. Click on the radio checkbox for CSV (Logins and Passwords only).
5. Click the Export Data button and save the CSV file to your computer.

Step 2: Import your data into Codebook

Instructions for macOS:

1. Launch Codebook on your Mac and sign in
2. Select File menu > Import > Import 1Password CSV...
3. In the open dialog that appears, choose the file you exported from 1Password
4. After the import process completes, verify that the passwords you imported are present in the Codebook interface

Instructions for Windows

1. Open the file you exported from 1Password in a spreadsheet editor
2. Edit the Title column and rename it to Entry
3. Insert a new column named Category and set the value for each row to 1Password (or whatever category name you prefer for each password record)
4. Do a Search for any pipe | characters in your passwords, and insert a backslash \ in front of them
5. Save your changes and ensure you save or export to a CSV file (not xls)
6. Launch Codebook on your PC and sign in
7. Select File menu > Import CSV
8. In the Open dialog, select the file you just edited
9. After the import process completes, verify that the passwords you imported are present in the Codebook interface

Step 3: Clean Up

1. Delete the unencrypted CSV export file from 1Password on your computer
2. If you had disabled your backup software, resume it now