Records import in detail
In this article, we explain in detail how to batch import your records to Passwd. You’ll also learn details about the file format and the values you can use to customize your records.
In case you don’t know how to start importing or exporting your records, see the instructions. In the following paragraphs, we explain record import only.
The template
Each record consists of 9 pieces of information. These pieces of information, or values, are saved in CSV format as text strings divided by commas (CSV is short for comma-separated values). Values can be also rendered in a table, which simplifies your work. To do so, use Excel or Google Sheets. In that case, each of the nine values will occupy one cell in a row. Now, let’s break the values down.
An important fact is that name of the record is always required. Without it, your import will fail. The rest of the fields are optional. Furthermore, the columns tags, Workspace group IDs with viewer/editor rights, and Workspace whitelist user IDs with viewer/editor rights can contain multiple values that can be separated by commas or commas followed by a space.
CSV example of import file
version,id,name,username,password,note,web,tags,GSuite group IDs - viewers,GSuite group IDs - editors,GSuite whitelist user IDs - viewers,GSuite whitelist user IDs - editors,ignoreSecurityReport,createdBy - id,createdBy - name,createdBy - email,TOTP - secret,createdAt
1,,Adobe,joe@passwd.team,4nrR485H!q=f,,https://adobe.com,"Work,Design",,,,,,,Joe Burrow,joe.burrow@passwd.team,,1715769933944
1,,Google,kate@passwd.team,NnJSm#6-2Kta,,https://google.com,"Work,Office,Storage",,,,,,,Kate Doe,kate.doe@passwd.team,,1715769933944
1,,Netflix,joe@passwd.team,xSnrmJa7J@X&,,https://netflix.com,"Entertainment",,,,,,,Joe Burrow,joe.burrow@passwd.team,,1715769933944
1,,Sketch,kate@passwd.team,xSnrmJa7J@X&,,https://sktech.com,"Work,Design",,,,,,,Kate Doe,kate.doe@passwd.team,,1715769933944
Version
Version specifies the version of the import file - currently version is 1
ID
ID is a unique identifier of each record. ID is created automatically by Passwd upon import, you do not need to provide one when adding a new record via import.
Name*
The name of the record. We recommend to be as descriptive as possible.
Username
Your username.
Password
Your password.
Note
Any kind of your own additional information.
Web
URL address of the website for which the account is used.
Tags
Your own tags to categorize the records. If you have more tags, separate them by commas or commas followed by a space.
You can use the tags you already have or add new ones.
GSuite group IDs - viewers
Gives permission to view records to your Workspace groups. If you have more IDs, separate them by commas or commas followed by a space.
You can obtain Workspace group IDs by exporting your records from Passwd.
GSuite group IDs - editors
Gives permission to edit records to your Workspace groups. If you have more IDs, separate them by commas or commas followed by a space.
You can obtain Workspace group IDs by exporting your records from Passwd.
GSuite whitelist user IDs - viewers
Gives permission to view records to individual Workspace users. If you have more IDs, separate them by commas or commas followed by a space.
You can obtain Workspace group IDs by exporting your records from Passwd.
GSuite whitelist user IDs - editors
Gives permission to edit records to individual Workspace users. If you have more IDs, separate them by commas or commas followed by a space.
You can obtain Workspace group IDs by exporting your records from Passwd.
Ignore Security Report
Specifies if the secret should be included in the security report or not
Created by - id
Id of the user that will be shown as the creator of the record. If it is empty, the record will be created under the current user
Created by - name
Name of the user that will be shown as the creator of the record.
Created by - email
Email of the user that will be shown as the creator of the record.
TOTP - secret
TOTOP secret in the format of base32 encoded string
Created at
If you want to set the creation of record different than now. The format is in a unix timestamp
Importing first records
Fill in the values. Mainly name and other columns you need. Except for the column ID. Do not fill the ID value when adding new records. It is created by Passwd automatically upon import.
Importing new records using an existing CSV file
If you want to use an existing, up-to-date CSV file (e.g. that you previously exported from Passwd), simply add new records below your existing data and import the file.
Importing new records using a new CSV file
You can also create a new CSV file and add new records into it. In that case, do not check the option Replace existing records. That would result in the loss of all your data stored in Passwd prior to the action.
Rewriting data
If you want to rewrite all your records with a new batch, create a new CSV file and check the option Replace existing records when importing your new data.
How to start
In case you don’t know how to start importing or exporting, see the instructions.
Passwd import template
version,id,name,username,password,note,web,tags,GSuite group IDs - viewers,GSuite group IDs - editors,GSuite whitelist user IDs - viewers,GSuite whitelist user IDs - editors,ignoreSecurityReport,createdBy - id,createdBy - name,createdBy - email,TOTP - secret,createdAt