Description and examples for using and managing Record Types
Within the Vault and via the commander CLI, it's possible to create records of a specific type. And if this capability is enabled by your Keeper Administrator, you can even create custom record type templates. Record Types define the fields available to a record. They act as a record blueprint, which makes it easy to create and manage records for a variety of different uses.
There is a set of standard record types defined by Keeper, these include common types like Login, Passport, and SSH Keys.
It is also possible to define new record types to be used by your organization.
For a list of associate record type commands, see commands documentation
add type=login title='my login' f.login=John.Doe f.password=75vf@5JB@o f.url=https://www.example.com f.oneTimeCode=otpauth://totp/Label?secret=Secret
record-type-info
record-type-info -lr login
record-type-info -lr login -e
Field
Description
text
text field
number
number field
login
Login field recognized by the KeeperFill
password
Password field which is masked and allows for password generation
name
First, Middle and Last text fields which make up a name
company
Plain text company name
phone
Phone number and type fields
email
Validated email address
address
Multiple fields which capture an address
addressRef
Reference to another record which is a address
date
Calendar date with validations. stored as unix milliseconds
expirationDate
Calendar date with validations. stored as unix milliseconds
birthDate
Calendar date with validations. stored as unix milliseconds
paymentCard
Validated card number, expiration, and security code fields
accountNumber
Plain text
groupNumber
Plain Text
bankAccount
Bank account information fields
cardRef
Reference to a bankCard
field in another record
note
Multiline text
url
URL text field. Can be followed as a link in the Vault
fileRef
Reference to a file field in another record
host
Multiple fields which capture host information
securityQuestion
Security Question and answer text fields
pinCode
Pin which is masked
oneTimeCode
Given the TOTP seed, provides the TOTP code
keyPair
Private and public keys in ASN.1 format
licenseNumber
Multiline text input
secret
A text input that is masked
Record Type
ID
login
1
bankAccount
11
birthCertificate
19
contact
20
driverLicense
21
encryptedNotes
22
file
23
healthInsurance
24
membership
26
passport
27
photo
28
serverCredentials
29
softwareLicense
30
ssnCard
31
general
32
sshKeys
34
databaseCredentials
40
Below you can see the fields in each record type, an example json representation, and and example of how to create a record of each type.
All record types have the following fields:
title
- what the record is named (required)
notes
- text
custom
- custom fields and values can be added to records. See add documentation for more information on adding custom fields
Name: login
Id: 1
Record Fields:
Field Name
Sub Field
Type
Field Label
login
Text
password
Text
url
Text
fileRef
oneTimeCode
Text
Add Record Example:
Dot Notation add type=login title='my login' f.login=John.Doe f.password=75vf@5JB@o f.url=https://www.example.com f.oneTimeCode="otpauth://totp/Label?secret=Secret"
JSON Data add --data '{"type": "login", "title": "my login", "fields": [{"type": "login", "value": ["John.Doe"]}, {"type": "password", "value": ["75vf@5JB@o"]}, {"type": "url", "value": ["https://www.example.com"]}, {"type": "oneTimeCode", "value": ["otpauth://totp/Label?secret=Secret"]}], "custom": []}'
Name: bankAccount
Id: 11
Record Fields:
Field Name
Sub Field
Type
Field Label
bankAccount
accountType
'Checking | Savings | Other'
bankAccount
otherType
Text
bankAccount
routingNumber
Text
bankAccount
accountNumber
Text
name
first
Text
name
middle
Text
name
last
Text
login
Text
password
Text
url
Text
cardRef
fileRef
oneTimeCode
Text
Add Record Example:
Dot Notation add type=bankAccount title='my bankAccount' f.bankAccount.accountType=Checking f.bankAccount.otherType=SomeText f.bankAccount.routingNumber=SomeText f.bankAccount.accountNumber=SomeText f.name.first=John f.name.middle=Danger f.name.last=Doe f.login=John.Doe f.password=75vf@5JB@o f.url=https://www.example.com f.oneTimeCode="otpauth://totp/Label?secret=Secret"
JSON Data add --data '{"type": "bankAccount", "title": "my bankAccount", "fields": [{"type": "bankAccount", "value": [{"accountType": "Checking", "otherType": "SomeText", "routingNumber": "SomeText", "accountNumber": "SomeText"}], "required": true}, {"type": "name", "value": [{"first": "John", "middle": "Danger", "last": "Doe"}]}, {"type": "login", "value": ["John.Doe"]}, {"type": "password", "value": ["75vf@5JB@o"]}, {"type": "url", "value": ["https://www.example.com"]}, {"type": "cardRef", "value": []}, {"type": "oneTimeCode", "value": ["otpauth://totp/Label?secret=Secret"]}], "custom": []}'
Name: address
Id: 14
Record Fields:
Field Name
Sub Field
Type
Field Label
address
street1
Text
address
street2
Text
address
city
Text
address
state
Text
address
zip
Text
address
country
Text
fileRef
Add Record Example:
Dot Notation add type=address title='my address' f.address.street1=SomeText f.address.street2=SomeText f.address.city=SomeText f.address.state=SomeText f.address.zip=SomeText f.address.country=SomeText
JSON Data add --data '{"type": "address", "title": "my address", "fields": [{"type": "address", "value": [{"street1": "SomeText", "street2": "SomeText", "city": "SomeText", "state": "SomeText", "zip": "SomeText", "country": "SomeText"}]}], "custom": []}'
Name: bankCard
Id: 18
Record Fields:
Field Name
Sub Field
Type
Field Label
paymentCard
cardNumber
Text
paymentCard
cardExpirationDate
Text
paymentCard
cardSecurityCode
Text
text
Text
cardholderName
pinCode
Text
addressRef
fileRef
Add Record Example:
Dot Notation add type=bankCard title='my bankCard' f.paymentCard.cardNumber=SomeText f.paymentCard.cardExpirationDate=SomeText f.paymentCard.cardSecurityCode=SomeText f.text=SomeText f.pinCode=SomeText
JSON Data add --data '{"type": "bankCard", "title": "my bankCard", "fields": [{"type": "paymentCard", "value": [{"cardNumber": "SomeText", "cardExpirationDate": "SomeText", "cardSecurityCode": "SomeText"}]}, {"type": "text", "value": ["SomeText"], "label": "cardholderName"}, {"type": "pinCode", "value": ["SomeText"]}, {"type": "addressRef", "value": []}], "custom": []}'
Name: birthCertificate
Id: 19
Record Fields:
Field Name
Sub Field
Type
Field Label
name
first
Text
name
middle
Text
name
last
Text
birthDate
Number
fileRef
Add Record Example:
Dot Notation add type=birthCertificate title='my birthCertificate' f.name.first=John f.name.middle=Danger f.name.last=Doe f.birthDate=1624485827145
JSON Data add --data '{"type": "birthCertificate", "title": "my birthCertificate", "fields": [{"type": "name", "value": [{"first": "John", "middle": "Danger", "last": "Doe"}]}, {"type": "birthDate", "value": [1624485827145]}], "custom": []}'
Name: contact
Id: 20
Record Fields:
Field Name
Sub Field
Type
Field Label
name
first
Text
name
middle
Text
name
last
Text
text
Text
company
email
Text
phone
region
Region
phone
number
Text
phone
ext
Text
phone
type
Home | Mobile | Work
addressRef
fileRef
Add Record Example:
Dot Notation add type=contact title='my contact' f.name.first=John f.name.middle=Danger f.name.last=Doe f.text=SomeText f.email=SomeText f.phone.region=US f.phone.number=(555)555-5555 f.phone.ext=3 f.phone.type=Mobile
JSON Data add --data '{"type": "contact", "title": "my contact", "fields": [{"type": "name", "value": [{"first": "John", "middle": "Danger", "last": "Doe"}], "required": true}, {"type": "text", "value": ["SomeText"], "label": "company"}, {"type": "email", "value": ["SomeText"]}, {"type": "phone", "value": [{"region": "US", "number": "(555)555-5555", "ext": "3", "type": "Mobile"}]}, {"type": "addressRef", "value": []}], "custom": []}'
Name: driverLicense
Id: 21
Record Fields:
Field Name
Sub Field
Type
Field Label
accountNumber
Text
dlNumber
name
first
Text
name
middle
Text
name
last
Text
birthDate
Number
addressRef
expirationDate
Number
fileRef
Add Record Example:
Dot Notation add type=driverLicense title='my driverLicense' f.accountNumber=SomeText f.name.first=John f.name.middle=Danger f.name.last=Doe f.birthDate=1624485827145 f.expirationDate=1624485827145
JSON Data add --data '{"type": "driverLicense", "title": "my driverLicense", "fields": [{"type": "accountNumber", "value": ["SomeText"], "label": "dlNumber"}, {"type": "name", "value": [{"first": "John", "middle": "Danger", "last": "Doe"}]}, {"type": "birthDate", "value": [1624485827145]}, {"type": "addressRef", "value": []}, {"type": "expirationDate", "value": [1624485827145]}], "custom": []}'
Name: encryptedNotes
Id: 22
Record Fields:
Field Name
Sub Field
Type
Field Label
note
Text
date
Number
fileRef
Add Record Example:
Dot Notation add type=encryptedNotes title='my encryptedNotes' f.note=SomeText f.date=1624485827145
JSON Data add --data '{"type": "encryptedNotes", "title": "my encryptedNotes", "fields": [{"type": "note", "value": ["SomeText"]}, {"type": "date", "value": [1624485827145]}], "custom": []}'
Name: file
Id: 23
Record Fields:
Field Name
Sub Field
Type
Field Label
fileRef
Add Record Example:
Dot Notation add type=file title='my file'
JSON Data add --data '{"type": "file", "title": "my file", "fields": [], "custom": []}'
Name: healthInsurance
Id: 24
Record Fields:
Field Name
Sub Field
Type
Field Label
accountNumber
Text
name
first
Text
insuredsName
name
middle
Text
insuredsName
name
last
Text
insuredsName
login
Text
password
Text
url
Text
fileRef
Add Record Example:
Dot Notation add type=healthInsurance title='my healthInsurance' f.accountNumber=SomeText f.name.first=John f.name.middle=Danger f.name.last=Doe f.login=John.Doe f.password=75vf@5JB@o f.url=https://www.example.com
JSON Data add --data '{"type": "healthInsurance", "title": "my healthInsurance", "fields": [{"type": "accountNumber", "value": ["SomeText"]}, {"type": "name", "value": [{"first": "John", "middle": "Danger", "last": "Doe"}], "label": "insuredsName"}, {"type": "login", "value": ["John.Doe"]}, {"type": "password", "value": ["75vf@5JB@o"]}, {"type": "url", "value": ["https://www.example.com"]}], "custom": []}'
Name: membership
Id: 26
Record Fields:
Field Name
Sub Field
Type
Field Label
accountNumber
Text
name
first
Text
name
middle
Text
name
last
Text
password
Text
fileRef
Add Record Example:
Dot Notation add type=membership title='my membership' f.accountNumber=SomeText f.name.first=John f.name.middle=Danger f.name.last=Doe f.password=75vf@5JB@o
JSON Data add --data '{"type": "membership", "title": "my membership", "fields": [{"type": "accountNumber", "value": ["SomeText"]}, {"type": "name", "value": [{"first": "John", "middle": "Danger", "last": "Doe"}]}, {"type": "password", "value": ["75vf@5JB@o"]}], "custom": []}'
Name: passport
Id: 27
Record Fields:
Field Name
Sub Field
Type
Field Label
accountNumber
Text
passportNumber
name
first
Text
name
middle
Text
name
last
Text
birthDate
Number
addressRef
expirationDate
Number
date
Number
dateIssued
password
Text
fileRef
Add Record Example:
Dot Notation add type=passport title='my passport' f.accountNumber=SomeText f.name.first=John f.name.middle=Danger f.name.last=Doe f.birthDate=1624485827145 f.expirationDate=1624485827145 f.date=1624485827145 f.password=75vf@5JB@o
JSON Data add --data '{"type": "passport", "title": "my passport", "fields": [{"type": "accountNumber", "value": ["SomeText"], "label": "passportNumber"}, {"type": "name", "value": [{"first": "John", "middle": "Danger", "last": "Doe"}]}, {"type": "birthDate", "value": [1624485827145]}, {"type": "addressRef", "value": []}, {"type": "expirationDate", "value": [1624485827145]}, {"type": "date", "value": [1624485827145], "label": "dateIssued"}, {"type": "password", "value": ["75vf@5JB@o"]}], "custom": []}'
Name: photo
Id: 28
Record Fields:
Field Name
Sub Field
Type
Field Label
fileRef
Add Record Example:
Dot Notation add type=photo title='my photo'
JSON Data add --data '{"type": "photo", "title": "my photo", "fields": [], "custom": []}'
Name: serverCredentials
Id: 29
Record Fields:
Field Name
Sub Field
Type
Field Label
host
hostName
Text
host
port
Text
login
Text
password
Text
fileRef
Add Record Example:
Dot Notation add type=serverCredentials title='my serverCredentials' f.host.hostName=https://www.example.com f.host.port=5000 f.login=John.Doe f.password=75vf@5JB@o
JSON Data add --data '{"type": "serverCredentials", "title": "my serverCredentials", "fields": [{"type": "host", "value": [{"hostName": "https://www.example.com", "port": "5000"}]}, {"type": "login", "value": ["John.Doe"]}, {"type": "password", "value": ["75vf@5JB@o"]}], "custom": []}'
Name: softwareLicense
Id: 30
Record Fields:
Field Name
Sub Field
Type
Field Label
licenseNumber
Text
expirationDate
Number
date
Number
dateActive
fileRef
Add Record Example:
Dot Notation add type=softwareLicense title='my softwareLicense' f.licenseNumber=SomeText f.expirationDate=1624485827145 f.date=1624485827145
JSON Data add --data '{"type": "softwareLicense", "title": "my softwareLicense", "fields": [{"type": "licenseNumber", "value": ["SomeText"]}, {"type": "expirationDate", "value": [1624485827145]}, {"type": "date", "value": [1624485827145], "label": "dateActive"}], "custom": []}'
Name: ssnCard
Id: 31
Record Fields:
Field Name
Sub Field
Type
Field Label
accountNumber
Text
identityNumber
name
first
Text
name
middle
Text
name
last
Text
fileRef
Add Record Example:
Dot Notation add type=ssnCard title='my ssnCard' f.accountNumber=SomeText f.name.first=John f.name.middle=Danger f.name.last=Doe
JSON Data add --data '{"type": "ssnCard", "title": "my ssnCard", "fields": [{"type": "accountNumber", "value": ["SomeText"], "label": "identityNumber"}, {"type": "name", "value": [{"first": "John", "middle": "Danger", "last": "Doe"}]}], "custom": []}'
Name: general
Id: 32
Record Fields:
Field Name
Sub Field
Type
Field Label
login
Text
password
Text
url
Text
oneTimeCode
Text
fileRef
Add Record Example:
Dot Notation add type=general title='my general' f.login=John.Doe f.password=75vf@5JB@o f.url=https://www.example.com f.oneTimeCode=SomeText
JSON Data add --data '{"type": "general", "title": "my general", "fields": [{"type": "login", "value": ["John.Doe"]}, {"type": "password", "value": ["75vf@5JB@o"]}, {"type": "url", "value": ["https://www.example.com"]}, {"type": "oneTimeCode", "value": ["SomeText"]}], "custom": []}'
Name: sshKeys
Id: 34
Record Fields:
Field Name
Sub Field
Type
Field Label
login
Text
keyPair
Text
host
hostName
Text
host
port
Unknown - Text
fileRef
secret
Text
Add Record Example:
Dot Notation add type=sshKeys title='my sshKeys' f.login=John.Doe f.keyPair=SomeText f.host.hostName=https://www.example.com f.host.port=Unknown - Text f.secret=SomeText
JSON Data add --data '{"type": "sshKeys", "title": "my sshKeys", "fields": [{"type": "login", "value": ["John.Doe"]}, {"type": "keyPair", "value": ["SomeText"]}, {"type": "host", "value": [{"hostName": "https://www.example.com", "port": "Unknown - Text"}]}, {"type": "secret", "value": ["SomeText"]}], "custom": []}'
Name: databaseCredentials
Id: 40
Record Fields:
Field Name
Sub Field
Type
Field Label
text
Text
type
host
hostName
Text
host
port
Text
login
Text
password
Text
fileRef
Add Record Example:
Dot Notation add type=databaseCredentials title='my databaseCredentials' f.text=SomeText f.host.hostName=https://www.example.com f.host.port=5000 f.login=John.Doe f.password=75vf@5JB@o
JSON Data add --data '{"type": "databaseCredentials", "title": "my databaseCredentials", "fields": [{"type": "text", "value": ["SomeText"], "label": "type"}, {"type": "host", "value": [{"hostName": "https://www.example.com", "port": "5000"}]}, {"type": "login", "value": ["John.Doe"]}, {"type": "password", "value": ["75vf@5JB@o"]}], "custom": []}'