> ## Documentation Index
> Fetch the complete documentation index at: https://docs.box.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adding Managed Users

export const InlineImage = ({src, alt = "", height = "1em"}) => {
  return <img noZoom src={src} alt={alt} style={{
    display: "inline-block",
    verticalAlign: "middle",
    height: height,
    width: "auto",
    margin: "0"
  }} />;
};

<div className="article_labels_list" style={{display: 'none'}} dangerouslySetInnerHTML={{__html: "User Management , Admin , Instructions , Article , Product Utilization , Established , Instruction"}} />

A "managed user" is a Box account that you directly control through your Admin Console. As an admin, you can add managed users; edit, delete, and enforce their security settings; and run activity reports on these users. Any files these users upload into folders they own will count against your total storage allocation.

When you add a managed user, you also configure their access to Box. You can add a single managed user or multiple managed users, up to 1,000 at once.

<Note>
  **Prerequisite**

  To add managed users, you must be:

  * An Admin
  * A Co-Admin with the *Manage users* permission enabled
  * A Group Admin
</Note>

**To add one or more managed users manually:**

1. Go to **Admin Console > Users and Groups**.
2. Click the **Managed Users** tab.
3. Click **Add Users** (<InlineImage src="/images/box-admin-tools/add-users-button.png" alt="add-users-button" />) and then click**Add Users Manually.**
4. Enter the managed user's name and email address.
5. Optionally select Groups for the user to be a member of and Folders for the user to have access to.
6. Optionally hover over a user row and click the gear icon (<InlineImage src="/images/box-admin-tools/gear-icon.png" alt="gear-icon-png" />) to configure other user settings for that new user or click <InlineImage src="/images/box-admin-tools/3-dots-button.png" alt="3-dots-button" /> and then click **Select User Settings for All Rows** to configure other user settings for all new users. See the [Managed Users Tab](/en/box-admin-tools/managing-box-users-and-admins/understanding-user-management/users-groups-settings#managed-users-tab) section of [Users & Groups Settings](/en/box-admin-tools/managing-box-users-and-admins/understanding-user-management/users-groups-settings) for details.
7. Optionally click **Add User** to add a row to the table. Then repeat steps 4 through 6 for each user.
8. Click **Save**.

Once you create the user, you can additionally [configure the user account](/en/box-admin-tools/managing-box-users-and-admins/managed-users/configuring-and-editing-users).

**To add multiple managed users:**

1. Go to **Admin Console > Users and Groups**.
2. Click the **Managed Users** tab.
3. Click **Add Users** (<InlineImage src="/images/box-admin-tools/add-users-button.png" alt="add-users-button" />) and then click**Add Users with CSV.**
4. Click the Box CSV Template link to download a sample CSV (comma-separated values) file.
5. Open the downloaded file in your application of choice. (A spreadsheet program works best.)
6. Enter the names, email addresses, and other information of the users you want to add. See [Valid .CSV Values](#valid-csv-values) for details.
7. Save the file as a CSV file. (You may want to save it with a new filename.)
8. Drag the file to the shaded area in the dialog box or click the link to upload the file.
9. Optionally select Groups for the users to be a member of and Folders for the users to have access to.
10. Optionally hover over a user row and click the gear icon (<InlineImage src="/images/box-admin-tools/gear-icon.png" alt="gear-icon-png" />) to configure other user settings for that new user or click <InlineImage src="/images/box-admin-tools/3-dots-button.png" alt="3-dots-button" /> and then click **Select User Settings for All Rows** to configure other user settings for all new users. See the [Managed Users Tab](/en/box-admin-tools/managing-box-users-and-admins/understanding-user-management/users-groups-settings#managed-users-tab) section of [Users & Groups Settings](/en/box-admin-tools/managing-box-users-and-admins/understanding-user-management/users-groups-settings) for details.
11. Click **Save**.

Once you create the users, you can additionally [configure the user accounts](/en/box-admin-tools/managing-box-users-and-admins/managed-users/configuring-and-editing-users).

<h2 id="valid-csv-values">
  Valid .CSV Values
</h2>

The .CSV file that you upload to add multiple managed users contains the following user data:

* Name
* Email
* Storage
* Shared Contacts
* Sync
* Restrict external collaboration
* Device pinning
* Language
* Groups

This section describes the valid values for each of these data types.

<ResponseField name="Name">
  Populates the Name field of the managed user. Limited to 100 ASCII characters or 50 double-byte characters.
</ResponseField>

<ResponseField name="Email">
  Populates the Email field of the managed user. Format must be \[login]@\[domain].\[tld]
</ResponseField>

<ResponseField name="Storage">
  Populates the Storage Allocated field of the managed user. Values must be:

  * Any numerical value 0 or greater. Fractional values will be rounded up. Represents the amount of storage in GB (gigabytes) that the managed user is allocated.
  * The literal text `unlimited`, which selects the Unlimited check box in the Storage Allocated field.
</ResponseField>

<ResponseField name="Shared Contacts">
  Selects the value for the Shared Contacts toggle in the Role and Access Permissions section of a managed user. Valid values are:

  * no
  * yes

  <Note>
    **Note**

    The default value for new managed users is `yes`.
  </Note>
</ResponseField>

<ResponseField name="Sync">
  Selects the value for the Box Sync toggle in the Role and Access Permissions section of a managed user. Valid values are:

  * no
  * yes

  <Note>
    **Note**

    The default value for new managed users is `no`.
  </Note>
</ResponseField>

<ResponseField name="Restrict external collaboration">
  Selects the value for the Restrict External Collaboration toggle in the Role and Access Permissions section of a managed user. Valid values are:

  * no
  * yes

  <Note>
    **Note**

    The default value for new managed users is `no`.
  </Note>
</ResponseField>

<ResponseField name="Device pinning">
  Selects the value for the Device Pinning toggle in the Role and Access Permissions section of a managed user. Valid values are:

  * no
  * yes

  <Note>
    **Note**

    The default value for new managed users is `no`.
  </Note>
</ResponseField>

<ResponseField name="Language">
  Populates the Language field of the managed user. Valid values (with their meaning) are:

  * `bn-IN` (Bengali/বাংলা)
  * `da-DK` (Danish)
  * `de-DE` (German)
  * `en-AU` (English - Australia)
  * `en-CA` (English - Canada)
  * `en-GB` (English - Great Britain)
  * `en-US` (English - United States)
  * `es-419` (Spanish/Español - Latin America/Latinoamérica)
  * `es-ES` (Spanish/Español)
  * `fi-FI` (Finnish/Suomi)
  * `fr-CA` (French/Français - Canada)
  * `hi-IN` (Hindi/हिन्दी)
  * `it-IT` (Italian/Italiano)
  * `ja-JP` (Japanese/日本語)
  * `ko-KR` (Korean/한국어)
  * `nb-NO` (Norwegian/Norsk (Bokmål))
  * `nl-NL` (Netherlands/Nederlands)
  * `pl-PL` (Polish/Polski)
  * `pt-BR` (Portuguese/Português)
  * `ru-RU` (Russian/Русский)
  * `sv-SE` (Swedish/Svenska)
  * `tr-TR` (Turkish/Türkçe)
  * `zh-CN` (Chinese-PRC/简体中文)
  * `zh-TW` (Chinese-Taiwan/繁體中文)
</ResponseField>

<ResponseField name="Groups">
  Populates the Groups section of the managed user. Enter one or more Group names separated by semicolons.

  <Note>
    **Note**

    Group names to be added in this method cannot contain a semicolon character. For any Group names that might contain a semicolon, add them manually after import by [editing the managed user account](/en/box-admin-tools/managing-box-users-and-admins/managed-users/configuring-and-editing-users).
  </Note>
</ResponseField>

## Troubleshooting Adding Multiple Managed Users

If Box cannot process all of the rows of an uploaded .CSV file, you will see an error message in the Add Users dialog box along with indicators to identify which records had issues. Click **Download Report** to download a .CSV file that you can review and clean up and attempt to upload again.