Add several users at once

Before people on your team can sign in and use your organization's Google services (for example, G Suite or Cloud Identity), they need a user account. If you have many users, you can add their accounts all at once from a spreadsheet. Also see Options for adding users.

Add users from a spreadsheet

Step 1: Download the template file

  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in

  2. From the Admin console Home page, go to Users.
  3. At the top of the page, click Bulk upload users.

    Roll over the floating action button to reveal the upload icon.

  4. Download the sample CSV (comma-separated values) template.
  5. Open the CSV file in a spreadsheet application, such as Google Sheets or Microsoft® Excel.

    The file has columns for the attributes that can appear in each user's profile. Profiles appear in the Admin console and users' Contacts manager.

Step 2: Enter users' information

  1. For each user you want to add, enter information in these columns in the spreadsheet:
  2. (Optional) Fill in the other columns only if you want. Otherwise, you can leave them blank.

    See the format guidelines below for help with entering information in columns, especially:

    • Multiple values in a column
    • Values with commas or line breaks, such as a physical address

Step 3: Save the file

After you've filled in the spreadsheet, save it as a CSV file (.csv). 


  • Maximum CSV file size is 35 MB.
  • Maximum number of records per file is 150,000.

    If your file is larger or has too many records, open it in your spreadsheet program, split the table into separate files, and save each one as a CSV file. Make sure you include the column headings row in all CSV files.

  • To upload non-ASCII or double byte usernames, first save the CSV file in UTF-8, including BOM.

Step 4: Upload the file

  1. After you've filled in the spreadsheet, save it as a CSV file.
  2. At the top of the Users page, click Bulk upload users.
  3. Click Attach CSV.
  4. Click Upload. If there's an error, enter the missing information in your spreadsheet and upload the file again. For more information, see common errors below.

    Your Tasks list opens automatically and shows the progress of the upload. Once processing is complete, you'll receive an email report.

    If there's a processing error, download the log file in your Tasks list. For more information, see common errors below.

It can take up to 24 hours for new users to have access G Suite services and appear in the global Directory. Learn more about the global Directory.

Follow spreadsheet format guidelines

General guidelines
  • Multiple values in a column—To enter multiple values in a single column, such as phone numbers and email addresses, separate them with a comma—for example:,
  • Values with commas, line breaks, or double quotes—Enclose the values in double quotation marks—for example, "123 Anystreet, Anytown"
  • Uploading non-ASCII or double byte usernames—Be sure to save the CSV file in UTF-8 so the usernames are readable.
  • Additional columns—You can enter information only in the columns available in the downloaded file. You can't add new columns, such as those for custom attributes.
  • Existing users—If you enter the email address or email alias of an existing user in the Email Address column, the existing user's account will be updated with any changes you make to their information in the other columns. 
Column reference
  • Email Address (and other email columns)—Use the format
  • Password—By default, passwords must be at least 8 characters. You can change password requirements for your organization.

    Note: If you're updating existing users and you don't want to change their passwords, make sure the Password column contains the symbols **** (4 asterisks).

  • Recovery Email and Recovery Phone—Recovery information used for login challenges.
    • Recovery email—Use an email address outside of your domain.
    • Recovery phone—Phone numbers must be in the E.164 format. They should start with the plus sign (+), followed by the country code, area code, and phone number. Entries can have a maximum of 15 digits. Example: +16505551212.
    • Employee ID—Some login challenges ask users to enter their employee ID. The ID can contain numbers, letters, and symbols. For details, see Add employee ID as a login challenge.
  • Work/Home Address—If you include commas or line breaks in an address, enclose the address in double quotation marks—for example, "123 Anystreet, Anytown"
  • New Primary Email: For editing existing user accounts only. Use this column to specify a new primary email address (username).
  • Org Unit Path—Use the format in the following examples​ to place users in an organizational unit—in either your top-level parent organizational unit or a child organizational unit below it. Learn more about organizational units.

    If you're not sure which organizational unit to place users in, you can move them to another organizational unit at any time after you upload them.


    • / (for the top-level parent)
    • /Sales (for a child below the top-level parent)
    • /Students/First Grade
  • Password Hash Function—To use hashed passwords, specify one of the following supported hash functions: MD5, SHA-1, or crypt. The Password column must contain the hashed password. For example, if you use SHA-1 and the hash of password abc is xyz, enter xyz in the Password column.

    Tip: You can find utilities on the web to generate hashed passwords using the supported hash functions.

  • Building ID, Floor Name, and Floor Section—To enter this information, follow these guidelines.
  • Change Password at Next Sign-InTo require a user to change their password the next time they sign in to their account, enter TRUE. Otherwise, leave the column empty or enter FALSE.
  • New Status [Upload Only]—For editing existing user accounts only. To archive or suspend a user, enter Archived or Suspended. To unarchive or restore a suspended user, enter Active.

Resolve common errors

Errors when you upload your CSV file

  • File is empty—Your file contains no information.
  • Incorrect file format or unknown column name—The columns in your file should be titled First Name, Last Name, Email Address, Password, and Org Unit Path.  
  • File must have the "column name" column—A required column is missing.
  • Empty column name in row nn—A column that requires information is empty in a specific row.
  • File is too large to upload—The CSV file is over 35 MB or there are more than 150,000 records in the file. Open the file and split the table into separate files. Save each one as a CSV file. Make sure you include the column headings row in all CSV files.
  • "Email Address [Required]" contains reserved username in row nn—Certain accounts are reserved and can't be created—for example, abuse and postmaster.
  • Read Only columns—Delete any "read only" columns before uploading the file.

Errors in the log file

  • ACTION FAILED - Validation—An entry contains unsupported characters. For help, see Username and group name guidelines.
  • ACTION FAILED: UNKNOWN ERROR—Most likely, a temporary error occurred. Try uploading the CSV file again, or uploading items in smaller batches.
  • ACTION FAILED: INSUFFICIENT LICENSES—Your organization's Google account doesn't have enough licenses for all the new users in your CSV file. Accounts are added starting from the top row until there are no more licenses available. You can purchase more licenses and then upload the remaining users in the CSV file.
  • RESERVED USERNAME - Email address—Certain accounts are reserved and can't be created—for example, abuse and postmaster.

Errors in your Tasks list

  • Internal error—Please try again later. If you continue to receive this error, contact support.
  • Formatting or other errors—Visit our discussion board for quick answers from fellow administrators.

Maintain user accounts

Edit accounts with a spreadsheet

You can save time when you need to edit multiple accounts by downloading a list of accounts from the Admin console. Important things to remember:

  • Any information in columns you can edit replaces existing information in the Admin console when you upload the file.
  • For columns you don't want to change, you can either delete them (if the column isn't required) or leave them and their information in the file.
  • If you delete information that's not required, but leave the associated column in the spreadsheet, the information is removed from the user's account when you upload the file.
  • If you don't want to change a user's password, make sure the Password column contains the symbols **** (4 asterisks).
  • To change a user's username, enter the new email address in the column New Primary Email.

Sync user data with your LDAP server

If you have an LDAP server, you can use Google Cloud Directory Sync to synchronize your Google users, groups, and shared contacts to match the information in your LDAP server.


Want someone to do this for you? Get professional help with setup.

Was this helpful?
How can we improve it?