---
schema_version: "1"
id: b50b177131cb8736c740c8f8f58923d54a0fc2974c59a4d3c25b9926c68c1e04
title: Add Users to Tableau Server
collection: tableau
version: current
locale: en-us
portal_url: https://docs.salesforce.com/tableau/current/en-us/server-linux/users_add.md
canonical_url: https://help.tableau.com/current/server-linux/en-us/users_add.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 34143dd493b6c2d1b8d1500e64a8a685ad976e5b16decb540ceaa7befbde82e6
description: Add users to Tableau Server one at a time or in batches.
---
[Skip to main content](#main-content)

# Add Users to Tableau Server

You can add users to Tableau Server one at a time or in batches. You can add them to the server as unlicensed users, and then add them to sites and assign site roles as you onboard them to Tableau Server. Or you can add users to sites and specify their site roles at the same time, at which point they are ready to sign in.

## Before you begin

- If your Tableau Server is configured with an Active Directory external identity store, review [User Management in Deployments with External Identity Stores](https://help.tableau.com/current/server-linux/en-us/users_manage_ad.htm) to understand how multiple domains, domain naming, NetBIOS, and Active Directory user name format influence Tableau user management.
    
    **Note:** In the context of user and group synchronization, Tableau Server configured with LDAP identity store is equivalent to Active Directory. Active Directory synchronization features in Tableau Server function seamlessly with properly configured LDAP directory solutions.
- Verify that you have enough user licenses and role licenses for your user base. If you attempt to add a user for a site role that you do not have a license for, then you will receive an error.
- To add user licenses to your Tableau Server deployment, visit the [Tableau Customer Portal](http://customer.tableausoftware.com/) to purchase licenses and the corresponding product key(s). After you have purchased licenses, see [Add Capacity to Tableau Server](https://help.tableau.com/current/server-linux/en-us/capacity_add.htm) to update the server with the new key(s).
- The steps in this topic describe how to add an individual user and assign their site role. To add users in batches, see [Import Users](https://help.tableau.com/current/server-linux/en-us/users_import.htm).

## When adding users at the server level versus the site level

In a single-site environment, server administrators can add users on the Users page.

![Option to Add Users on Tableau Cloud.](/tableau/current/en-us/server-linux/en-us/Img/sites_add_user_ss_list.png)

After you add a site to Tableau Server, it becomes a multi-site server with a Server Users page (all server users from every site appear here) and a Site Users page. Only server administrators can access the Server Users page, and both site administrators and server administrators can access the Site Users page.

![Site Users on Tableau Cloud.](/tableau/current/en-us/server-linux/en-us/Img/sites_add_user_siteusers.png)

The Server Users page is the only place where you can assign users to multiple sites, delete users from the server, and if the server is using local authentication, reset user passwords.

![A list of Tableau Server users with option to Add Users.](/tableau/current/en-us/server-linux/en-us/Img/sites_addusers1.png)

## Add a user to the server

When adding a user, the workflow changes depending on whether at least one [identity pool](https://help.tableau.com/current/server-linux/en-us/identity_pools.htm) is configured for Tableau Server.

### No identity pools configured

If no identity pools are configured, i.e., Tableau Server is only using the user provisioning and authentication configured during Tableau Server setup (also referred to as the initial pool (TSM configured)), follow the steps described below to add a user.

1. In the site menu, select Manage All Sites > Users, and then click Add Users.
    
    To add a user to a site, you select the site and go to the Users page.
    
    ![Option to Add Users on Tableau Server.](/tableau/current/en-us/server-linux/en-us/Img/sites_adduser_srv.png)
2. Do one of the following:
    
    - If the server is configured for **local authentication**, click New User, and enter a user name. With local authentication, the best way to avoid user name collisions is to provide an email address for the user name. For example, _jsmith@example.com_ instead of _jsmith_.
        
        User names are not case sensitive. Characters not allowed in user names include the semi-colon (;) and colon (,).
    - If the server is configured for **Active Directory authentication**, click Active Directory User. If you are adding a user from the same Active Directory domain that Tableau Server runs on, the server domain will be assumed, and you can type the AD user name without the domain.
        
        **Note:** Do not enter the user’s full name; this can cause errors during the importing process.
3. If the server is using local authentication, provide the following:
    
    - Display Name—Type a display name for the user (e.g., _John Smith_).
    - Password—Type a password for the user.
    - Confirm password—Retype the password.
    - Email—This is optional and can be added at a later time in the user profile settings.
    - Selected users are Server Administrators: Specify whether the user should be a server administrator.
    - Name (Site Membership) / Site Role: If the user is not a server administrator, you can assign a user to zero or more sites, along with a site role for each site. You do not have to choose site membership and site role at this time. If you don’t specify site membership and site role for a new server user, the user will be added as a server user only, with a site role of Unlicensed. For details, see [Set Users’ Site Roles](https://help.tableau.com/current/server-linux/en-us/users_site_roles.htm).
4. Click Create.
    
    ![Add a new user on Tableau Server form.](/tableau/current/en-us/server-linux/en-us/Img/sites_adduser_srv2.png)

### One or more identity pools configured

When adding a user, if one or more identity pools are configured, you must first select an identity pool or the initial pool (TSM configured), which is the user provisioning and authentication configured in TSM during Tableau Server setup.

1. In the site menu, select Manage All Sites > Users, and then click Add Users > Create new user.
    
    To add a user to a site, you select the site and go to the Users page.
    
    ![Option to Add Users on Tableau Server.](/tableau/current/en-us/server-linux/en-us/Img/sites_adduser_srv_create_new_user.png)
2. In the Add New Users dialog box, select the identity pool you want to add the user to.
    
    ![Add new users from an Initial Pool.](/tableau/current/en-us/server-linux/en-us/Img/sites_adduser_idpool_select.png)
3. Do one of the following:
    
    - If the identity pool you selected in step 2 is configured for LOCAL identity store and LOCAL authentication:
        
        1. In the New User dialog box, in the Username text box, enter a user name. With local authentication, the best way to avoid user name collisions is to provide an email address for the user name. For example, _jsmith@example.com_ instead of _jsmith_.
            
            User names are not case sensitive. Characters not allowed in user names include the semi-colon (;) and colon (,).
            
            ![Add New User dialog box.](/tableau/current/en-us/server-linux/en-us/Img/sites_adduser_idpool_local_newuser.png)
        2. Enter the following information:
            
            - Display name—Type a display name for the user (e.g., _John Smith_).
            - Password—Type a password for the user.
            - Confirm password—Retype the password.
            - Email (optional)—This is optional and can be added at a later time in the user profile settings.
            - Selected users are Server Administrators: Specify whether the user should be a server administrator.
            - Site Role: If the user is not a server administrator, you can assign a site role. You do not have to choose site role at this time. If you don’t specify site role for a new user, the user will be added as a server user only, with a site role of Unlicensed. For details, see [Set Users’ Site Roles](https://help.tableau.com/current/server-linux/en-us/users_site_roles.htm).
        3. When finished, click Create User.
    - If the identity pool you selected in step 2 is configured for LOCAL identity store with OIDC authentication:
        
        1. In the New User dialog box, in the Username text box, enter a user name. With local authentication, the best way to avoid user name collisions is to provide an email address for the user name. For example, _jsmith@example.com_ instead of _jsmith_.
            
            User names are not case sensitive. Characters not allowed in user names include the semi-colon (;) and colon (,).
            
            ![Add New User dialog box.](/tableau/current/en-us/server-linux/en-us/Img/sites_adduser_idpool_local_newuser_ad.png)
        2. Enter the following information:
            
            - Display name—Type a display name for the user (e.g., _John Smith_).
            - Password—Type a password for the user.
            - Identifier (optional)—Type the identifier you want to associate with the user. Identifiers are for identity matching purposes. For more information, see [Usernames and identifiers in Tableau](https://help.tableau.com/current/server-linux/en-us/identity_pools.htm#usernames_identifiers).
            - Email (optional)—This is optional and can be added at a later time in the user profile settings.
            - Site and Site role—If the user is not a server administrator, you can assign a user to zero or more sites, along with a site role for each site. You do not have to choose site membership and site role at this time. If you don’t specify site membership and site role for a new server user, the user will be added as a server user only, with a site role of Unlicensed. For details, see [Set Users’ Site Roles](https://help.tableau.com/current/server-linux/en-us/users_site_roles.htm).
            - Make selected users Server Administrators—Specify whether the user should be a server administrator.
        3. When finished, click Create User.
    - If the identity pool you selected in step 2 is configured for ACTIVE\_DIRECTORY or LDAP identity store:
        
        1. Type the AD or LDAP user name without the domain. In this workflow, you're adding a user from the same Active Directory domain that Tableau Server was configured with in TSM during Tableau Server setup. Therefore, the server domain will be assumed, and you can type the AD or LDAP user name without the domain.
            
            **Note:** Do not enter the user’s full name; this can cause errors during the importing process.
            
            ![Import Users from Active Directory.](/tableau/current/en-us/server-linux/en-us/Img/sites_adduser_idpool_ad.png)
        2. When finished, click Import Users.