Managing Users
- Last updated
- Save as PDF
What Can I Do on the Users Screen?
Administrators can use the Users screen in Planview Admin to manage Planview Admin users, including the following tasks:
- Add a User Manually
- Adding Existing Users to a Product Environment
- Deactivating users
- Reactivating users
- Deleting users
- Edit a user's details
- Configure users to Login with Username & Password
- Reset users' passwords
- Make or remove a user as an Admin
- Export the user list to a CSV file
- Importing users into Planview Admin with a CSV file
NOTE
Future Planview Admin releases will add functionality such as adding new users for each available product; for now, continue adding new users directly in the appropriate product environment.
Users Screen Elements
The following table describes the screen elements and the tasks that administrators can perform on this screen.
| Element | Description |
|---|---|
| Filter | Click the Filter icon, which allows Administrators to filter users by name, email, users assigned to specific products, role, status, if the password required option is activated, and last login date. |
| Add user | Click the Add user button to add a user manually. |
| Actions |
Unless otherwise noted, the following options in the Actions menu affect the users selected with the check boxes on the left side of the screen:
|
| First name | The user's first name. |
| Last name | The user's last name. |
| The user's email address. | |
| Role | The role assigned to a user regarding Planview Admin. (Administrator, User) |
| Password Required | Identifies which users must sign in using a username and password. When SSO is not configured, all users will have a check in this field. When SSO is configured, only users with the Require password (bypass SSO) setting enabled will show a check in this field. |
| Products | The Planview product environments that the user has access to. |
|
Status |
Active indicates users who have accessed Planview Admin. By default, users who sign in using SSO are automatically set to active Pending indicates users invited to Planview Admin, but have not yet accepted the invite and created a password. |
| Last Login |
Displays the date the user last logged in to Planview Admin, specifically. NOTE: This does not surface or log product-specific last login dates. The date a user last logged into a product will be displayed in the product-specific user grid. |
|
|
Click the action menu (
|
Adding a User Manually
You can add a user to Planview Admin, but you will not be able to map that user until a corresponding user in the product environment (with matching email address) has been created.
- On the Users screen, click the Add user button.
- Enter the First name, Last name and Email.
- Require password (bypass SSO) is disabled by default, and should only be used if your organization uses SSO and the user will bypass the SSO system.
- Click Add.
Once you create a corresponding user in the product environment (if one doesn't already exist), the users will be linked by matching email addresses at the next sync.
Adding Existing Users to a Product Environment
If you need to add an existing user to a product environment for Roadmaps or Planview.Me in Planview Admin, you can do that from the Users screen.
To add existing users to a product environment for Roadmaps or Planview.Me:
- On the Users screen, check the checkbox next to each user that needs to be added to the environment(s).
- Open the Actions menu in the upper-right corner.
- Click Add product environments.
- In the modal that appears, check the box for each environment you want to add the selected users to.
- Click Add.
You may not see the results immediately. You will receive an email when all selected users are added to the selected environments.
NOTE
This option cannot be used to remove users from a product environment.
Deactivating Users
You can deactivate a user from Planview Admin; they will now appear in the Deactivated users tab of the Users screen and will not be able to access Planview Admin. Deactivated users will be removed from their product assignments in Planview Admin and they will no longer be able to authenticate with Planview Admin. Deactivated users may be either reactivated to regrant their access to Planview Admin, or deleted to anonymize and remove their user records from Planview Admin.
NOTE
You will still need to deactivate users in the product environment to free up licenses and terminate resource(s) so that they will no longer be considered to have capacity.
To deactivate one user:
For the user you want to deactivate, perform one of the following steps:
- Click
> Deactivate user. The Deactivate User confirmation window will appear.
- Click Deactivate user to confirm, or No to cancel.
To deactivate multiple users:
- Click the checkbox on the left side for each user you want to deactivate. Alternatively, you can click the checkbox at the top of the user list to select all displayed users.
NOTE
The user list can only display 1000 users at time, so clicking the checkbox at the top of the list only selects the users that are displayed. To select all users, click Select All when it appears after clicking the checkbox.
- Click Actions > Deactivate user. The Deactivate User confirmation window will appear.
- Click Deactivate users to confirm, or No to cancel.
Reactivating Users
You can reactivate a user from Planview Admin; they will now appear in the Current users tab of the Users screen and be in the applications they were assigned upon reactivating them. Once a user sync runs, the remainder of their product access will be returned to them.
To reactivate one user:
For the user you want to reactivate, perform one of the following steps:
- Click
> Activate user. The Activate User confirmation window will appear.
- Select the product environments to reassign their access to once they are reactivated.
- Click Activate to confirm, or Cancel to cancel.
To reactivate multiple users:
- Click the checkbox on the left side for each user you want to reactivate. Alternatively, you can click the checkbox at the top of the user list to select all displayed users.
NOTE
The user list can only display 1000 users at time, so clicking the checkbox at the top of the list only selects the users that are displayed. To select all users, click Select All when it appears after clicking the checkbox.
- Click Actions > Activate user. The Activate User confirmation window will appear.
- Select the product environments to reassign their access to once they are reactivated.
- Click Activate to confirm, or Cancel to cancel.
Deleting Users
You can delete a user from Planview Admin once they have been deactivated; they will no longer appear in the Deactivated users tab of the Users screen, their PII will be anonymized, and they will no longer be able to be reactivated.
To delete one user:
For the user you want to delete, perform one of the following steps:
- Click
> Delete user. The Delete User confirmation window will appear.
- Click Delete to confirm, or No to cancel.
To delete multiple users:
- Click the checkbox on the left side for each user you want to delete. Alternatively, you can click the checkbox at the top of the user list to select all displayed users.
NOTE
The user list can only display 1000 users at time, so clicking the checkbox at the top of the list only selects the users that are displayed. To select all users, click Select All when it appears after clicking the checkbox.
- Click Actions > Delete user. The Delete User confirmation window will appear.
- Click Delete to confirm, or No to cancel.
Modifying User Details
Administrators can edit the names and email addresses of users in Planview Admin.
To modify a user's details:
- Click
> Edit user, or click the checkbox for the user on the left side, then click Actions > Edit user.
- On the Edit user screen, change the First name, Last name, Email, Require password (bypass SSO) and check the box for each environment you want to add the selected users to in Product environments.
- Click Save.
Configuring a User to Login with Username & Password
If your organization has SSO configured and turned on, Planview Admin supports the ability for certain users to login with username and password instead of SSO. The main use case for enabling a user to login with password is if your organization routinely interacts with or needs the ability to add users that are external to your organization. When the require password (bypass SSO) setting is enabled for a user, that user will receive an account creation email from Planview Admin.
Resetting User Passwords
To reset one user's password:
- For the user whose password you want to reset, perform one of the following steps:
- Click
> Reset password.
- Click the check box for the user on the left side. Then click Actions > Reset password.
- Click
The user's password is reset immediately and an email is sent to the user.
To reset multiple users' passwords:
- Click the checkbox on the left side for each user whose password you want to reset. Alternatively, you can click the checkbox at the top of the user list to select all displayed users.
NOTE
The user list can only display 1000 users at time, so clicking the checkbox at the top of the list only selects the users that are displayed. To select all users, click Select All when it appears after clicking the checkbox.
- Click Actions > Reset password.
The users' passwords are reset immediately and emails are sent to the users.
Give and Remove Planview Admin User Administrator Rights
To give (or remove) Planview Admin Administrator rights:
- For the user whose role you want to change, perform one of the following steps:
- Click
> Promote to administrator or Remove administrator role.
- Click the check box for the user(s) on the left side. Then click Actions > Promote to administrator or Remove administrator role.
- Click
Exporting User Details to a CSV File
You can export a CSV file with details about all users in Planview Admin, including the name, email address, and status for each user; whether they are an administrator; and which product environments they have access to.
To export a CSV file of users in Planview Admin:
- (Optional) Use the filters to the left of the user lists to select the users to be exported. You can also select individual users in the list. If you want to export all users in Planview Admin, skip this step.
- Click Actions > Export users.
- Select a location to save the exported file.
- Click Save.
The users you selected will be exported to a file called Users.csv in the location you selected.
Importing User Details with a CSV File
You can create news users or edit existing user details by importing a CSV file created from a template that you can download from Planview Admin. Details you can import include the name, email address for each user, and whether they are an administrator. You can select which product environments they have access to during the import.
Creating new users by CSV import
To create new users with a CSV import:
- Click Actions > Import users.
- If you do not have a CSV prepared, click Download template. The template has all of the columns that need to be filled in to create a new user.
- Click Choose File and select a CSV file to import.
- Select the product environments you want the imported users to have access to. At this time, only the applications managed by Planview Admin are allowed to be selected.
- For products with different subscription types, select a subscription type for all users that will be imported.
NOTE
If there are not enough subscriptions of your selected type, the users will not be imported.
- For products where you can assign a product role, select a product role for all users that will be imported.
- Click Import.
NOTE
If you attempt to upload a file larger than 20MB, you will receive an error message when importing it. If your file is larger than this, please break it up.
Your CSV import will begin processing. You can continue working in Planview Admin while the import processes. You will receive an email notification when the import is completed.
Updating existing users by CSV import
If you want to update existing users instead of creating new users, your import file must include the ID column from a Planview Admin user export and the correct ID values for each user. This is the system identifier required to match updates rows to existing users. Without the ID column, rows will be matched on email address only and treated as duplicates. In most cases the row update would be ignored during import, but in rare instances users may be unintentionally duplicated.
The import template does not include this column. You can create a CSV file for updating existing from a user export CSV.
WARNING
The values in the ID column are unique to Planview Admin. They will not the same as any ID values from your organization's own systems, the Login Alias, or the User ID field found in Portfolios.
To create a CSV import file to update existing users:
- Export user details to CSV as described in the section above.
- Click Actions > Import users.
- Click Download template. This will help you remove extraneous columns before importing.
- In the exported CSV from step 1, remove all of the columns that do not appear in the import template.
The CSV is ready to be updated and imported back into Planview Admin.
NOTE
In the following fields, leaving a blank cell means no change will be made:
- First Name
- Last Name
- Username
- Login Alias
In other fields, a blank cell will clear out the existing value.
To update existing users with a CSV import:
- Click Choose File and select a CSV file to import. The file must include the ID column from a Planview Admin user export (see above).
- Select the product environments you want the imported users to have access to. When updating users, existing product access is not removed. At this time, only the applications managed by Planview Admin are allowed to be selected.
- For products with different subscription types, select a subscription type for all users that will be imported.
NOTE
If there are not enough subscriptions of your selected type, the users will not be imported.
- For products where you can assign a product role, select a product role for all users that will be imported.
- Click Import.
NOTE
If you attempt to upload a file larger than 20MB, you will receive an error message when importing it. If your file is larger than this, please break it up.
Your CSV import will begin processing. You can continue working in Planview Admin while the import processes. You will receive an email notification when the import is completed.

