Skip to content

Import new HubSpot users with a CSV file

Last updated: June 30, 2025

Available with any of the following subscriptions, except where noted:

All products and plans

If you're a Super Admin or a user with Add and edit users permissions, you can bulk import users with a CSV file during the user creation process.

Please note: on March 5, 2024, HubSpot introduced a seats-based pricing model to all new Hubs and subscription tiers. Accounts created prior to March 5, 2024 will not see this new import feature until they are migrated to the seats-based pricing model.

Prepare the import file

To import users in bulk, the spreadsheet must:

  • Be a .csv file. 
Include a column for the users’ Email. The spreadsheet may also include the following columns:
  • First name
  • Last name
  • Team
  • Seat

When setting up your import, you can refer to this user sample spreadsheet: CSV.

A sample spreadsheet showing how to format the spreadsheet for importing users in bulk.

Please note: it is recommended to use the formatting shown in the user sample spreadsheet. However, to import multiple values in one row instead, add a comma between each value without spaces (e.g., value 1,value 2). Using a semicolon instead of a comma will result in an error. 

Import new users

  1. In your HubSpot account, click the settings settings icon in the top navigation bar.
  2. In the left sidebar menu, navigate to Users & Teams.
  3. Above the user table, in the upper right, click Import Users.

user-management-import-users

  1. Under Users file, click Choose a file to upload the CSV file. You can also drag and drop the file into the import tool. 
  2. To select the language for the column header, click the dropdown menu and select a language
  3. In the bottom right, click Next

User import, showing option to upload the import spreadsheet.

  1. In the Mapping Guide table, click the HubSpot Property dropdown menus and select the corresponding HubSpot properties for each column header from the file. 

User import, showing the mapping guide during the import process.

  1. If there's an error with the mapping:
    •  In the Mapped column, click [#] errors. An overview of the error will appear in the right panel. 
    • In the Replacement value column, click the dropdown menu and select an existing property in your HubSpot account. 
    • To ignore the value, click the vertical menu icon and select Don’t import this value
    • You can also resolve this error in your CSV file and then reimport your file. Learn more about resolving import file errors.
  2. After resolving any errors, click Next.
  3. Continue to set up user access levels.
user-management-fix-import-errors

 

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.