1
0
mirror of https://github.com/bitwarden/help synced 2025-12-06 00:03:30 +00:00
Files
help/_articles/importing/import-data.md
fred_the_tech_writer 906e2ca0dd Promote to Master (#748)
* initial commit

* adding quotes for the array error

* Create Gemfile

* Create Gemfile.lock

* add .nvmrc and .node-version

* removed /article from URL

* update links to work with netlify

* more fixed links

* link fixes

* update bad links

* Update netlify.toml

toml test for redirects

* article redirect

* link fixes

* Update index.html

* Update netlify.toml

* Update _config.yml

* Update netlify.toml

* Update netlify.toml

* Update netlify.toml

* Update netlify.toml

* Update netlify.toml

* add article back into URL for launch

* Update netlify.toml

* Update netlify.toml

* add order to categories front matter

* Update netlify.toml

* update

* sidemenu update

* Revert "sidemenu update"

This reverts commit 5441c3d35c.

* update order prop

* Navbar updates per Gary and compiler warnings

* font/style tweaks

* Update sidebar.html

* Stage Release Documentation (#739)

* initial drafts

* rewrite Custom Fields article to prioritize new context-menu option & better organize ancillary information

* edit

* edit

* Custom Field Context Menu & CAPTCHA item in release notes

* SSO relink event

* update rn

* small edits

* improve release notes titles

* fix side menu

* Edits courtest of mportune!

* update order

* link fixes

* link cleanup

* image updates and a link

* fix trailing slash

Co-authored-by: DanHillesheim <79476558+DanHillesheim@users.noreply.github.com>
2021-09-21 13:21:11 -04:00

4.6 KiB

layout, title, categories, featured, popular, tags, order
layout title categories featured popular tags order
article Import Data to your Vault
import-export
true true
import
01

Bitwarden provides a data import tool for easy migration from any password management solution to your personal Vault or Organization Vault. You can also use the data import tool to import from one Bitwarden Vault to another, or to import a Bitwarden Encrypted Export.

For a full list of supported import formats, see What file formats does Bitwarden support for import?, or use one of these articles for importing from the most popular solutions:

{% callout success %} Not already signed up? Choose from one of Bitwarden's plans{:target="_blank"} and get started today:

Create Your Free Account {% endcallout %}

Import to your Personal Vault

Importing data to Bitwarden can only be done from the Web Vault{:target="_blank"} or CLI. Data is encrypted locally before being sent to the server for storage. To import your data:

  1. In the Web Vault, select Tools from the top navigation bar.

  2. Select Import Data from the left-hand Tools menu.

  3. From the format dropdown, choose a File Format (see What file formats does Bitwarden support for import?).

  4. Select the Choose File button and add the file to import or copy/paste the contents of your file into the input box.

    {% callout warning %}Import to Bitwarden can't check whether items in the file to import are duplicative of items in your Vault. This means that importing multiple files will create duplicative Vault items if an item is already in the Vault and in the file to import.{% endcallout %}

  5. Select the Import Data button to complete your import.

  6. After successful import, delete the import source file from your computer. This will protect you in the event your computer is compromised.

Currently, file attachments are not included in Bitwarden import operations and will need to be uploaded to your Vault manually. For more information, see File Attachments.

Troubleshooting

The following error messages, typically received when attempting to import a .csv, indicate that an item in your import file has a specified value that exceeds the allowed encrypted character limit for its field type:

{% image importing/ciphererror_2021.png Cipher errors in the Web Vault%}

To solve this issue, open the .csv file in a text editor or spreadsheet program and remove or reduce the character count of the offending item. Bitwarden won't import your .csv file until it is free of offenses. The contents of the error messages contain several pieces of pertinent data to help you identify the offending item. For example, in the above example:

  • [1] identifies the index number where the offending item is located, adjusted to match row numbering in most spreadsheet programs.

  • [Login] identifies the Vault item type of the offending item.

  • "Facebook" identifies the name of the offending item.

  • Notes indicates the field (column) where the character limit is exceeded.

  • 10000 indicates the character limit allowed for that field (column).

    {% callout success %}On import to Bitwarden, the character count of any given field is increased due to encryption, meaning that an 8000-character Notes field in your .csv will scale to 10,000+ characters when it comes into contact with Bitwarden, triggering this error. As a rule of thumb, character counts will grow between 30-50% when encrypted.{% endcallout %}

If you continue to have trouble locating the offending item using the data provided in the error, it may help to focus first on notes as these are frequently the cause of this error.