Importing users into Snipe-IT is pretty straightforward. In the GUI importer, simply select the file containing users that you'd like to import, and then map the fields accordingly.

You can find a sample CSV to start from in the source on Github.

Mappable Fields

Field	Example	Required	Notes
ID	`123`	No	This is only needed or used when you wish to change existing users' usernames. If this is not included, `username` will serve as the lookup key. This field will be ignored on user creation and is only used on updates.
Username	`jsmith`	On Update	While it is highly recommended that you supply the username, the system will try to create one based on the settings you have in `Admin > General Settings` for how your usernames look (last name first, etc)
First Name	`Jane`	On Create	User's given name.
Last Name	`Smith`	No	User's surname/last name.
Email	`[email protected]`	No	An email address is not required, however if you wish to utilize any of the email notification features, only users with email addresses will be sent notifications.
Display Name	`Jane P. Smith`	No	This name will be used instead of the `First Name Last Name` generated full name if one is provided.
Gravatar	`[email protected]`	No	This field is only used if you want to use gravatar's avatar service, and the users' email address is different there than the one within your organization.
Phone	`+1 555-555-5555`	No	User's phone number.
Mobile	`+1 554-554-5544`	No	User's mobile number.
Website	`https://snipeitapp.com`	No	User's website URL.
Job Title	`Chief Mohawk Officer`	No	User's job title.
Address	`123 Park Place`	No	User's street address.
City	`Lisboa`	No	User's city.
State	`Lisbon`	No	User's state/province.
Country	`PT`	No	User's country. We generally recommend using the capital version of the two-letter abbreviation so that matches our UI dropdowns and remains consistent.
Postal Code	`1111-1111`	No	User's postal code.
Start Date	`2024-01-04`	No	User's start date. This must be in `YYYY-MM-DD` format if a value is provided.
End Date	`2025-02-03`	No	User's end date. This must be in `YYYY-MM-DD` format if a value is provided.
Employee Number	`EMP123456`	No	User's employee number.
Department	`Human Resources`	No	Snipe-IT will create a corresponding department if one with a matching name does not exist.
Manager Username	`elevy`	No	Snipe-IT will try to match the username provided here to populate the `manager_id` field for the user.
Remote	`1` or `Yes`	No	Determines whether the user is a remote user or not. This field is mostly made available so that API queries can filter on them.
VIP	`0`, or `No`	No	Determines whether the user is a VIP or not. This field is mostly made available so that API queries can filter on them.
Activated	`1` or `Yes`	No	Determines whether the user can login to the Snipe-IT system.

Welcome Emails on User Creation

Welcome emails inviting users to set/update their password will ONLY be sent if the user has a valid email address in the import CSV, they are set to activated (meaning they can login to the system), and if the "Send welcome email" checkbox is checked on import.

Welcome emails are only sent on user creation, not user updates.