In this article:
If you have a large fleet of keys, it may be more efficient to create your keys all at once instead of one at a time. A bulk key upload will allow you to do that. Using a CSV file, you can set names and associated details for all your keys, then upload it into the Keycafe app.
Key Uploads on Mobile
Note that bulk key uploads can only be done on the desktop app.
Create a CSV Import File
The following table lists the fields that you can include in the file:
| Field | Description |
|---|---|
| Name | Required. The key name. |
| Description | The key description. |
| Internal Notes | The internal notes. These will not be displayed to the guest. The maximum length is 100 characters. |
| Street | The street address. |
| Unit | The address unit number. |
| City | The address city. |
| State/Province | The address state or province. |
| Country | The address country. |
| Postal Code | The address postal code. |
| Serial Number | The serial number of the Keycafe fob. |
| Key Code | If set to "true", generates a key code for the key. |
Enabling Key Codes
If you wish to assign key codes to each key, make sure to activate Key Codes in your account prior to uploading your CSV file.
Download Sample Import File
Download our CSV template to help you best organize your data before importing.
CSV Formatting
When creating your CSV file, make sure you are using comma delimiters, not semicolons. Additionally, if you have a comma in a field description, the description must be in quotes. The correct format will look like this:
value1,value2,value3
OR
"value,1","value,2","value,3"
Upload Your Keys
- Log in to Keycafe desktop.
- Select Settings.
- Select Imports, then Import Keys.
- Click on Choose File to select a CSV file from your computer.
- Select Import Data.
Your import is added to the queue and the keys are added when the import process is complete. You can visit the Imports page to check your progress at any time.
Import Errors
If an import fails, you can view the error and make the appropriate fix.
Import Limitations
There are also the following limitations to bulk uploading your keys:
- The import CSV data file must contain no more than 500 rows of data.
- The import CSV data file cannot be larger than 2 MB.