> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Users to Domo

export const InlineImage = ({src, alt = '', height = '1.6em'}) => {
  return <img noZoom src={src} alt={alt} style={{
    display: 'inline',
    verticalAlign: 'start',
    height: height,
    margin: '0'
  }} />;
};

### Intro

You can add users to your Domo instance either [individually](#add_individual_users) or in [bulk](#add_users_bulk). You can only do this if you have the Admin or Privileged default security role or a custom role with the Add New People grant enabled.

When you add users to Domo, Domo does the following:

* Sets up a
  [Profile page](/s/article/360042934674) for the user.
* Adds the user's name to the list in the **People** section of the Governance settings.
* Sends an email to the user with a link to join Domo.

  Depending on settings, Domo may only allow you to add people whose email address contains an authorized domain. For more information, see [Specifying Authorized Domains for Invited Users](/s/article/360042934534 "Specifying Authorized Domains for Invited Users"). For information about inviting users to join Domo, see [Inviting Others to Join Domo](/s/article/360043438893 "Inviting Others to Join Domo"). For information about how an added user connects to Domo and finishes setting up an account, see Joining Domo.

***

* [Add individual users](#add_individual_users)
* [Add/edit users in bulk](#add_users_bulk)
  * [Save CSV file with UTF-8](#save_csv_file_with_utf-8)
  * [Example list](#example_list)
* [Videos](#videos)

***

### Add Individual Users

You can add users to Domo individually in the **Add New Person** dialog, which you can access from the navigation header. When you invite a user to Domo, you can fill in their personal and contact information, upload a photo, and specify their security role.

Follow these steps to add a single user to Domo:

1. From the navigation header, select
   <InlineImage src="/images/kb/ka0Vq000000EdeD-00N5w00000Ri7BU-0EM5w000005vODa.png" /> **Add** > **People** > **Person**.

   The **Add new person** dialog displays.

   **Note:** This dialog also contains the option to bulk import. Selecting this option displays the **Bulk import** dialog. Learn about [adding users in bulk](#add_users_bulk) below.

   <Frame>
     <img alt="Screenshot 2023-06-28 at 5.17.13 PM.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/J3x-O8qWbl7BB1F9/images/kb/ka0Vq000000EdeD-00N5w00000Ri7BU-0EM5w000006v9Nr.jpg?fit=max&auto=format&n=J3x-O8qWbl7BB1F9&q=85&s=45b8991769f33c8722a0632fd3df77ca" style={{width: 490, height: 240.98}} width="1450" height="714" data-path="images/kb/ka0Vq000000EdeD-00N5w00000Ri7BU-0EM5w000006v9Nr.jpg" />
   </Frame>
2. Enter the user's full name and email address in the appropriate fields.
3. Select a security role for the user from the menu. For more information about security roles, see the
   [Default Security Role Reference](/s/article/360043438953).
4. Select **Invite**.

   The new user's [Profile page](http://wiki.domo.com/confluence/display/DHCS/Viewing+and+managing+user+profiles "Profile Page Layout") displays, and their name and basic information appears in the **People** page of the Governance settings. In addition, an email is sent to the address you entered for the user, providing instructions on how to join Domo. Invited users must then complete several more steps to join Domo.

   **Note:** If an error message indicates you need to provide a proper email address and the email address you specified is properly formed, then you cannot add that person because that email domain is not authorized. For more information, see [Specifying Authorized Domains for Invited Users](/s/article/360042934534 "Specifying Authorized Domains for Invited Users").
5. (Optional) On their **Profile** page, you can enter the user's phone number, title, and employee number.

   <Note>
     **Note:**

     * Users can edit their name and phone number on their
       **Profile** page
     * Users
       *cannot* edit their email address and employee number on their **Profile** page. These settings are only editable in the Admin Settings.
     * Enter only numbers (up to 16 digits) in the employee numbers field.
   </Note>

### Add/Edit Users in Bulk

You can add/edit users or groups in bulk by uploading a CSV file containing the information for all the users or groups you want to add/replace. This is faster than adding many new users individually or by using the Domo API.

You must have an Admin or Privileged default security role or a custom role with the Manage All Users grant enabled to use this feature. Learn more about [default security roles](/s/article/360043438973).

Follow these steps to access bulk import:

1. From the navigation header, select **More** > **Admin**.

   The Admin Settings display.
2. Under **Governance**, select **People**.
3. On the **People** page, select **Bulk Import**.

   <Frame>
     <img alt="bulk import.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/J3x-O8qWbl7BB1F9/images/kb/ka0Vq000000EdeD-00N5w00000Ri7BU-0EM5w000006v8YZ.jpg?fit=max&auto=format&n=J3x-O8qWbl7BB1F9&q=85&s=0ec90522714743eb3fba4fd151fce1be" style={{width: 688.999, height: 160.994}} width="2094" height="486" data-path="images/kb/ka0Vq000000EdeD-00N5w00000Ri7BU-0EM5w000006v8YZ.jpg" />
   </Frame>

   The **Bulk import** dialog displays.

   <Frame>
     <img alt="Screenshot 2023-06-27 at 5.28.19 PM.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/J3x-O8qWbl7BB1F9/images/kb/ka0Vq000000EdeD-00N5w00000Ri7BU-0EM5w000006v8Yt.jpg?fit=max&auto=format&n=J3x-O8qWbl7BB1F9&q=85&s=36979e0300faf843c04d1379c7ef7740" style={{width: 436.996, height: 769.986}} width="920" height="1622" data-path="images/kb/ka0Vq000000EdeD-00N5w00000Ri7BU-0EM5w000006v8Yt.jpg" />
   </Frame>

   In the dialog, you can upload a CSV file with your user information. See an [example list](#example_list) of columns to include in your CSV file below. The required columns are indicated with an asterisk (\*). You can also download a sample CSV file with the columns you need to fill in with your own data (select **Download example** in the dialog).

   <Frame>
     <img alt="download example.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/J3x-O8qWbl7BB1F9/images/kb/ka0Vq000000EdeD-00N5w00000Ri7BU-0EM5w000006v9P9.jpg?fit=max&auto=format&n=J3x-O8qWbl7BB1F9&q=85&s=c5c5e1568ba58018768b3e42634755dc" style={{width: 405.98, height: 75.9943}} width="920" height="174" data-path="images/kb/ka0Vq000000EdeD-00N5w00000Ri7BU-0EM5w000006v9P9.jpg" />
   </Frame>

   Fill in the sample file with the required information and any other information you would like to include. Then save the file and upload it to the dialog.
4. (Conditional) Select an option for entries in your file:

   * Add new people
   * Add new people and edit existing profiles

   **Note:** Empty values in the new DataSet override current values. Omitting the column maintains the current values.
5. (Conditional) If the import file contains group data for your users, check **Create new group(s)** to bring those groups into Domo.
6. (Optional) Indicate whether to enforce UTF-8 format. Enforcing UTF-8 requires the presence of a UTF-8 BOM (Byte Order Mark) at the beginning of the file that allows the reader to more reliably know that the file is correctly encoded in UTF-8 format. To learn how to save your CSV file using UTF-8 encoding, see
   [below](#save_csv_file_with_utf-8).
7. Finally, drag your import file into the upload area or select **Browse** and navigate to the file on your computer. All of the users in the spreadsheet are imported to Domo and their new or updated information populates the correct fields in the Admin Settings and user **Profile** pages.

# Save CSV File with UTF-8

If you intend to save your CSV import file using UTF-8 encoding, you cannot simply change the encoding type when saving; otherwise you receive an error telling you to check the names of your column headers. As a workaround to this issue, you can do the following:

1. Save the file in CSV format.
2. Open the file in a text application.
3. Save the file with UTF-8 encoding. The way to do this depends on the application.

You can now upload the file by returning to the [bulk import workflow](#add_users_bulk) above.

# Example List

Required columns are indicated by an asterisk (\*).

<table border="1" data-aura-rendered-by="33:209;a"><thead><tr><td colspan="1" rowspan="1"><b> Column Header </b></td><td colspan="1" rowspan="1"><b> Type </b></td><td colspan="1" rowspan="1"><b> Valid values/format </b></td></tr></thead><tbody><tr><td colspan="1" rowspan="1"> \*email </td><td colspan="1" rowspan="1"> Email </td><td colspan="1" rowspan="1"> Example: <a href="mailto:johnsmith@domo.com"> [johnsmith@domo.com](mailto:johnsmith@domo.com) </a></td></tr><tr><td colspan="1" rowspan="1"> \*displayName </td><td colspan="1" rowspan="1"> String </td><td colspan="1" rowspan="1"> Example: John Smith </td></tr><tr><td colspan="1" rowspan="1"> edit </td><td colspan="1" rowspan="1"> Boolean </td><td colspan="1" rowspan="1"><p> Example: TRUE/FALSE </p><div class="mdx-embed"><Note><p><b> Note: </b> This column value overrides the edit mode provided by the form. </p></Note></div></td></tr><tr><td colspan="1" rowspan="1"> newEmail </td><td colspan="1" rowspan="1"> String </td><td colspan="1" rowspan="1"><p> Example: <a href="mailto:johnsmith@newDomain.com"> [johnsmith@newDomain.com](mailto:johnsmith@newDomain.com) </a></p><div class="mdx-embed"><Note><p><b> Note: </b> This will change the person's identifying email address and login. </p></Note></div></td></tr><tr><td colspan="1" rowspan="1"> alternateEmail </td><td colspan="1" rowspan="1"> Email </td><td colspan="1" rowspan="1"> Example: <a href="mailto:johnsmith@domo.com"> [johnsmith@domo.com](mailto:johnsmith@domo.com) </a></td></tr><tr><td colspan="1" rowspan="1"> title </td><td colspan="1" rowspan="1"> String </td><td colspan="1" rowspan="1"> Example: Software Engineer </td></tr><tr><td colspan="1" rowspan="1"> roleId </td><td colspan="1" rowspan="1"> Number </td><td colspan="1" rowspan="1"><p> Enter a number: <br /> 1 (Admin) <br /> 2 (Privileged) <br /> 3 (Editor) <br /> 4 (Participant) <br /> 5 (Social) </p><div class="mdx-embed"><Note><p><b> Note: </b> If the Custom Role feature is enabled for your instance, you can also enter a user's custom Role ID. <p /><p> Find the Role ID by going to <b> Admin </b> > <b> Governance </b> > <b> Roles </b>. Select the role from the list and go to the <b> Details </b> tab. Locate the <b> Role ID. </b></p><p /><p><img alt="non cloud admin.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/J3x-O8qWbl7BB1F9/images/kb/ka0Vq000000EdeD-00N5w00000Ri7BU-0EMVq000001REMT.jpg?fit=max&auto=format&n=J3x-O8qWbl7BB1F9&q=85&s=01e80ce0787054d8bd94e629472decb7" style={{width: 325, height: 402}} width="830" height="1026" data-path="images/kb/ka0Vq000000EdeD-00N5w00000Ri7BU-0EMVq000001REMT.jpg" /></p></p></Note></div></td></tr><tr><td colspan="1" rowspan="1"> phoneNumber </td><td colspan="1" rowspan="1"> International phone number </td><td colspan="1" rowspan="1"> Example: (800) 899-1000 </td></tr><tr><td colspan="1" rowspan="1"> deskPhoneNumber </td><td colspan="1" rowspan="1"> International phone number </td><td colspan="1" rowspan="1"> Example: (800) 899-1000 </td></tr><tr><td colspan="1" rowspan="1"> employeeNumber </td><td colspan="1" rowspan="1"> Number </td><td colspan="1" rowspan="1"><p> Example: 123 </p><div class="mdx-embed"><Warning><p><b> Important: </b> Employee number is being replaced by Employee ID. Please use Employee ID instead. </p></Warning></div></td></tr><tr><td colspan="1" rowspan="1"> employeeId </td><td colspan="1" rowspan="1"> String </td><td colspan="1" rowspan="1"><p> Example: ABC123 </p><div class="mdx-embed"><Note><p><b> Note: </b> This attribute is overridden by the employeeNumber value when provided to Domo through an SSO login. This is different from Employee# and will not show up in the UI. </p></Note></div></td></tr><tr><td colspan="1" rowspan="1"> locale </td><td colspan="1" rowspan="1"> Locale language tag </td><td colspan="1" rowspan="1"> Valid values: <br /> de-DE, de-AT, de-CH, en-AU, en-CA, en-150, en-HK, en-IE, en-IL, en-MO, en-NZ, en-SG, en-GB, en-US, en-001, es-ES, es-US, es-419, es-MX, fr-BE, fr-CA, fr-FR, fr-CH, nl-BE, nl-NL, pt-BR, pt-PT, ja-JP, zh-CN, zh-Hans-HK, zh-Hans-MO, zh-Hans-SG </td></tr><tr><td colspan="1" rowspan="1"> location </td><td colspan="1" rowspan="1"> String </td><td colspan="1" rowspan="1"> Example: Utah </td></tr><tr><td colspan="1" rowspan="1"> sendInvite </td><td colspan="1" rowspan="1"> Boolean </td><td colspan="1" rowspan="1"><p><br /> Example: TRUE/FALSE </p><div class="mdx-embed"><Note><p><b> Note: </b> This column will override customer settings for sending an invite email. </p></Note></div></td></tr><tr><td colspan="1" rowspan="1"> groups </td><td colspan="1" rowspan="1"> String </td><td colspan="1" rowspan="1"><p> Example: groupname1,groupname2 <a id="videos" target="_blank" /></p><div class="mdx-embed"><Note><p><b> Note: </b> Separate each group name with a comma. </p></Note></div></td></tr></tbody></table>

### Adding New Users to Domo (video)

<iframe allowfullscreen="allowfullscreen" frameborder="1" height="315" src="//www.youtube-nocookie.com/embed/_mnPXOVlBNw" width="560" />

### Bulk Import Users (video)

<iframe allowfullscreen="allowfullscreen" frameborder="1" height="315" src="//www.youtube-nocookie.com/embed/QMAO1MrjDP0" width="560" />
