Import
The import feature is located under "Restore or Import" in the "Backup and Restore" section which is accessed through the "🗃" icon in the app navigation. It can be used to restore a previously made backup, import a backup from another instance or import data from another password manager.
Choose the format of the file you want to import. If you want to import a CSV file from an application which is not listed, choose "Custom CSV".
Select the file you want to import. If you want to import a custom csv file, make sure to set the csv options before you open the file.
Select the options for the import. Depending on the file type, different options may be available which are explained below.
If you're ready to go, hit the "Import" button and start importing your files
Most of the imports for files from a third party service are just a profile with preselected options for the CSV import. There are some imports which do have special options just for that service. The description of these options dav be found in the import guide for that service.
- Import from Passman
- Import from Chrome
- Import from database backup
- Import from Enpass
- Import from custom CSV
The "Conflict handling" mode defines how the Importer should handle conflicts. "Skip if same revision" will skip an entry if it already exists and the revision matches. Works only if the import contains a revision field. "Skip always" will skip an entry if it already exists in the database. "Overwrite existing" will overwrite an entry if it already exists in the database. "Merge with existing" will merge the new data with the current data. This does not apply for custom fields. "Create new entry" will always create a new entry, even if it already exists.
Note: If no id field is available, entries will be matched by their name. The "Database Backup" option will always use id based matching.
If this option is selected, passwords which were shared with you by other users will not be overwritten by the import.
Some password managers create faulty export files which can not be parsed by the importer. These files need to be fixed manually in order to work properly.
- Open the file in a spreadsheet program like LibreOffice Calc or Microsoft Excel.
- Check the file for errors. Most of these programs do a good job in fixing faulty CSVs. You should make sure that all colums are filled in properly.
- Export the file as CSV.
- Try the Import again
Some password managers (e.g. Passman, Enpass, Bitwarden) allow files to be stored with passwords. The Import will show the warning ""Password Name" has files attached which can not be imported." for each password which has files attached. The password will be imported anyway but the files will not be imported. Passwords does not offer any file storage functionality as we believe that it is better to leave this to Nextcloud itself.
Passwords does support the linking of files stored in Nextcloud to passwords. Therefore we recommend downloading the files manually from your old Password manager and storing them in Nextcloud. After this you can edit the password and add a custom field with the type "file" and choose the file from the file dialog.
Note: If you want to store secret files like private keys, we recommend that you use the Nextcloud E2E Encryption.
If you have custom fields with a label that exceeds 48 characters or a value that exceeds 320 characters, it will be truncated to fit the length limitations of Passwords. Custom fields are intended to contain usual password related information like and e-mail address or the like. They are not intended to hold large amounts of data. If you want to store long texts, we recommend to use the "Notes" field.
If you import passwords with custom fields from any source other than the "Database Backup", they will be validated. Fields with the type "url" or "email" will require to be in a correct format or their type will be set to "text". Additionally, all fields with the type "text" will be checked if they are in the right format for "url" or "email" and if so, their type will be changed.