Tableau users must be added to the appropriate Tableau Cloud site or Tableau Server site before they can sign in and access published content. An administrator can add users individually through the web interface or add multiple users by importing a CSV file.

This tutorial explains how to create users in Tableau through the graphical user interface and assign an appropriate site role during the process.

Ways to Add Users in Tableau

  1. Add one or more users through the Tableau web interface.
  2. Import multiple Tableau users from a CSV file.

The web interface is suitable when you need to add a small number of users. CSV import is generally more convenient when onboarding many users at the same time.

Permissions Required to Create Tableau Users

You need an administrative role with permission to manage users. Depending on the Tableau deployment and assigned role, this may be a server administrator or site administrator.

If the user-management options are not visible after signing in, confirm that your account has permission to add users to the selected site.

Create Users from the Tableau Web Interface

Step 1: Sign In to Tableau and Open the Correct Site

Sign in to Tableau Cloud or Tableau Server with an administrator account. If your deployment contains multiple sites, select the site to which the new user should be added.

Step 2: Open the Tableau Users Page

Open the Users page from the site administration area, and then select the option to add users.

Creating Tableau Users

Step 3: Choose How to Add Tableau Users

Click the + Add Users button. Tableau may provide options for entering user details directly or importing users from a file. Choose the direct-entry option when adding one or a few users.

Step 4: Enter the User Email Address and Site Role

Enter the user’s email address or username, depending on the authentication method configured for the Tableau deployment. Select a site role that matches the access the user requires, and then click Add Users.

Step 5: Confirm the New Tableau User

After Tableau processes the request, confirm that the new account appears on the Users page. Review the displayed site role before granting access to workbooks, projects, or data sources.

Select an Appropriate Tableau Site Role

A site role defines the maximum level of access a user can receive on a Tableau site. It works together with project, workbook, view, and data-source permissions.

  • Viewer: Intended for users who primarily open and interact with published views.
  • Explorer: Intended for users who explore published content and may perform web-based editing when permissions allow.
  • Creator: Intended for users who connect to data, create content, and publish workbooks or data sources.
  • Unlicensed: Keeps the user account on the site without granting licensed access.
  • Site administrator roles: Provide administrative capabilities and should be assigned only when required.

The exact roles available can depend on the Tableau product, licensing model, and administrator permissions. Assign the least-privileged role that still allows the user to complete their work.

Add Multiple Tableau Users with a CSV File

For bulk onboarding, select the file-import option from the Add Users workflow. Prepare the CSV file in the format expected by your Tableau deployment, upload it, review any validation messages, and then complete the import.

Before importing, check that usernames or email addresses are unique, required fields are present, and assigned site roles are valid. Correct any rejected rows and import them again.

Tableau User Authentication and Site Access

Creating a user record does not replace the authentication system configured for Tableau. The user’s sign-in identity must be recognized by the authentication method used by the Tableau environment.

Tableau Cloud commonly identifies users by email address. Tableau Server may use local authentication or an external identity service configured by the organization. Usernames must match the identities expected by that authentication system.

Grant Tableau Content Permissions After Adding a User

Adding a user and assigning a site role does not automatically grant access to every workbook or project. Content permissions determine what the user can view, edit, download, publish, or manage.

Where possible, add users to groups and assign project-level permissions to those groups. Group-based access is usually easier to review and maintain than assigning permissions separately to every user.

Troubleshoot Tableau User Creation Problems

  • Add Users is unavailable: Confirm that your account has user-management permission for the selected site.
  • The user already exists: Search the users list and review the existing account, site membership, and site role.
  • The username is rejected: Verify that it matches the identity format required by the configured authentication provider.
  • The site role cannot be assigned: Check available licenses and confirm that your administrator role permits the assignment.
  • The user can sign in but cannot see content: Review project, workbook, view, and data-source permissions.
  • A CSV import fails: Check the file structure, required columns, role names, duplicate identities, and row-specific validation errors.

Tableau User Management Questions

Can a site administrator create users in Tableau?

A site administrator can manage users when the assigned administrative role and deployment settings provide that permission. Server-wide administration may require a server administrator.

Why can a new Tableau user sign in but not see a workbook?

The user’s site role permits a maximum level of access, but workbook and project permissions determine whether the content is visible. Check the user’s group membership and the permissions applied to the relevant project or workbook.

Can multiple users be added to Tableau at once?

Yes. Administrators can use the available file-import workflow to add multiple users. The CSV must follow the format supported by the Tableau environment.

What is the difference between a Tableau site role and content permissions?

A site role defines the maximum capabilities available to the user on the site. Content permissions control the actions that user can perform on specific projects, workbooks, views, and data sources.

Verify the New Tableau User Account

The user-creation process is complete when the account appears on the correct Tableau site, has the intended site role, can authenticate successfully, and has access only to the required content. Review group membership and project permissions before considering the account ready for use.