Home  >   Getting Started with Vtiger   >  Managing CRM Users

Managing CRM Users

Add your employees as CRM users to log into their Vtiger CRM accounts, access information, and perform tasks accordingly.
R
Ruba
17 May, 2024 - Updated 4 months ago
Table of Contents

Introduction

Users are the employees of your company who use the CRM. Every user has a CRM account with a unique set of login credentials and access to the features included in your plan.
 

User-employee dependency

 
Every user is an employee, but every employee is not a user.
The User field in the Employees module is used to identify employees who are CRM users.
 When you create a user in Vtiger CRM, an employee record is automatically created for the user and the User field is enabled.
However, when you create an employee, no user record is created. Thus, the User field is not enabled.
 To learn more about Employees in Vtiger CRM, click here.
 
Note: If an employee record already exists with the same Primary Email as the Username in the user record, then the user is linked to the employee.
 

Feature Availability

 
Sales/Help Desk Starter Sales/Help Desk Professional Sales Enterprise All-in-One Professional All-in-One Enterprise
Feature Availability
Users
 

Important Fields in Users

 
Field name Description
Username Mandatory field
The email address using which the user logs in to Vtiger
User Type Mandatory field
The type of the user: 
  • Standard: Standard users have access to every module. You can allow/deny access to specific modules and control their privileges through Profiles
  • Admin: Admin users have complete access to the CRM including the CRM Settings.
  • Light Agent:  Light Agent users have complete access to the Organizations, Contacts, Leads, Comments, and Calendar modules. They can view and create access to Cases and Internal Tickets.
  • Single App: Single App users have complete access to one of the five apps (Marketing, Sales, Help Desk, Projects, Inventory) and read-only access to records in other apps.
To learn more about Light Agent and Single App users, click here.
Role Mandatory field
The user’s role, for example, CEO, VP of Sales, etc.
Reports To The reporting manager of the user
Primary Group The group or team which the user belongs to, for example, Marketing, Sales, etc.
Language The language in which the user wants to use the CRM
Primary Email Mandatory field
The primary email of the user, which, may or may not be the same as the Username
 To learn about the other fields in Users, click here.
 

Adding a User

You can add users to the CRM only if you are an Admin user or the CRM account owner.
 Follow these steps to add a user:
  1. Log in to your CRM account.
  2. Click the User Menu on the top right corner of the CRM screen.
  3. Click Settings.
  4. Look for the User Management section.
  5. Select Users.
  6. Click the +Add User button.
  7. Enter the following information:
    1. User Information - User’s primary information such as username, password, group, user type, etc.
    2. Employee Information - User’s work-related name, primary email, department, phone number, etc.
    3. User Address - User’s address information that includes details such as street, city, state, etc. 
    4. Currency and Number Preferences - User’s currency-related details such as preferred currency, digit grouping pattern, symbol placement, etc.
    5. Phone Preferences - User’s phone extension number for incoming and outgoing calls
    6. Business Hours - User’s business hours
    7. Vtiger Usage Preferences -Other usage-related preferences such as default login page, default record view, etc.
    8. Signature - User’s signature to be included at the end of emails
  8. Click Save.
 
Hint: You can skip fields that are non-mandatory. Mandatory fields are identified by an * (asterisk) beside them. Here are the mandatory fields in Users:
  • Username
  • Role
  • User Type
  • Password
  • Confirm Password
  • Last Name
  • Primary Email
To learn about Roles in Vtiger CRM, click here.
To learn about Profiles in Vtiger CRM, click here.
 To learn more about the user information mentioned above, click here.

Identifying user creation Dates

Vtiger displays date fields to help you identify the users you added to Vtiger CRM in the middle of a Billing cycle. This also helps Vtiger CRM generate accurate invoices.

User records will display the following three date fields:

  • Created time: Displays the date and time when the user is created in the CRM
  • Reactivated On: Displays the date and time the last time the user was reactivated
  • Suspended On: Displays the date and time of the last time the user was suspended

You will also be able to generate a new report named - User Summary report with the following information:

  • Username
  • Status
  • Created time
  • Suspended On
  • Reactivated ON

Email verification of new users

Email verification, in general, helps you clean up your email list by validating email addresses to improve deliverability. By verifying emails in Vtiger, you can avoid spoofing and prevent emails from landing in the spam folder.
 When you add a user and click Save, a verification email is sent to the email addresses mentioned in the Username and Primary Email fields. Users must click the verification link in the email to be able to send emails from Vtiger. 
 
Hint: Unverified email addresses are identified by an exclamation mark beside them. 
 

Changing the Username 

If a user’s username is no longer in use, then it can be changed. As an Admin user, you can change the username in a few simple steps. 
 Follow these steps to change the username:
  1. Log in to your CRM account.
  2. Click the User Menu on the top right corner of the CRM screen.
  3. Click Settings.
  4. Look for the User Management section.
  5. Select Users.
  6. Hover over the user whose username you want to change.
  7. Click the More icon.
  8. Choose the Change Username option.
  9. Enter the new username and password. Confirm the password.
  10. Click Save.
 After saving, you must verify the new username.
 
  1. Open the user record with the new username.
  2. Click the exclamation mark beside the Username field.
  3. Click the Click here link in the tooltip.
 
Note: If you are a Standard user, then you can request a CRM admin to change your username. 
 There’s also an alternative way to change a user’s username: 
 
  1. Log in to your CRM account.
  2. Click the User Menu on the top right corner of the CRM screen.
  3. Click Settings.
  4. Look for the User Management section.
  5. Select Users.
  6. Click the user record whose username you want to change.
  7. Click the More icon on the top right corner of the user record. 
  8. Select the Change Username option.
  9. Enter the new username, password, and confirmed password. 
  10. Click Save.
 A verification email is sent to the new email address in the Username field. The user must click the verification link in the email to verify the new username.
 

Changing the Password

As an Admin user, you can change your password as well as other users’. 
 Follow these steps to change the password:
  1. Log in to your CRM account.
  2. Click the User Menu on the top right corner of the CRM screen.
  3. Click Settings.
  4. Look for the User Management section.
  5. Select Users.
  6. Hover over the user whose password you want to change.
  7. Click the Change Password icon.
  8. Enter the new password and confirmation password.
  9. Click Save.
 There’s also an alternative way to change a user’s password: 
 
  1. Log in to your CRM account.
  2. Click the User Menu on the top right corner of the CRM screen.
  3. Click Settings.
  4. Look for the User Management section.
  5. Select Users.
  6. Click the user record whose password you want to change.
  7. Click the More icon on the top right corner of the user record. 
  8. Select the Change Password option.
  9. Enter the new password and confirmed password. 
  10. Click Save.
 

Changing the Access Key

Access Key is a unique security token generated automatically when a user is created. It is used for authentication in REST APIs/Web Services.
 Follow these steps to change a user’s access key:
  1. Log in to your CRM account.
  2. Click the User Menu on the top right corner of the CRM screen.
  3. Click Settings.
  4. Look for the User Management section.
  5. Select Users.
  6. Click the user record whose access key you want to change.
  7. Click the More icon on the top right corner of the user record. 
  8. Select the Change Access Key option.
  9. Click Yes to confirm.
 After your access key is updated, you must replace the old access key with the new one in all the extensions that you use.
 

Logging in as Another User

As an Admin user, you can log in to the CRM as another user. 
 Why would you want to do that?
There may be a few instances where you may need to log in as another user. For example, if a user is not able to figure out how to set up something or you want to personalize the CRM for them, you can log in to their account. 
But make sure you have their permission to do so!
 Follow these steps to log in as another user:
  1. Log in to your CRM account.
  2. Click the User Menu on the top right corner of the CRM screen.
  3. Click Settings.
  4. Look for the User Management section.
  5. Select Users.
  6. Hover over the user that you want to go in as.
  7. Click the Log in as (User) icon.
  8. Click Yes to confirm.
  9. Choose your preferences such as country, time zone, language, etc.
    • These preferences can be changed after logging in.
  10. Click Finish.
 

Importing Users

If you have a users’ list on your local computer and you want to add them as users in the CRM, you can simply import the list. Imported users can log in to the CRM after the import is successful, using their username and password.
 You can import users using two methods.
 Alternative 1: Importing users from Settings > Users
 Follow these steps to import users into Vtiger CRM:
  1. Log in to your CRM account.
  2. Click the User Menu on the top right corner of the CRM screen.
  3. Click Settings.
  4. Look for the User Management section.
  5. Select Users.
  6. Click the Import button located on top of the Users page.
  7. Upload a CSV file:
    1. Click Select File from Computer.
    2. Browse through your computer and select a file.
    3. Enable the Source file has a header checkbox if your CSV file has a header column.
    4. Choose the type of character encoding.
    5. Choose a delimiter. The delimiter separates items in the CSV file.
    6. Click Next.
  8. Set up field mapping:
    1. Map the fields in your CSV file to the CRM fields.
    2. Click Import.
 
Note: When importing user records, the import process may fail in the following cases:
  • Users already exist
  • Password and Confirm Password fields do not match
  • Empty values for mandatory fields and no default values are specified
 Alternative 2: Importing users from the Main Menu > Import module
 Follow these steps to import users into Vtiger CRM:
Step 1: Go to the Import screen
  1. Log in to your CRM account.
  2. Click the Main Menu.
  3. Go to Tools.
  4. Select Import.
    • If you do not see the Import module, contact your CRM admin to enable the module or give you access to it.
  5. Click +New Import.
 Step 2: Select a file to import under the Select File tab
  1. Enter a title for the import process.
  2. Select the Users module from the Select Module drop-down.
  3. Select the format of the file you want to import under Select File Format? 
  4. Enable the Has Header checkbox if applicable.
    • Note: Headers are column names in your local file. They make mapping column values to CRM fields easy.
  5. Choose a Character Encoding type.
    • Note: Make sure the Character Encoding matches the one selected in the local file.
  6. Choose a delimiter.
    • Note: Delimiter is the character that separates fields in your local file. The CRM identifies different fields with the help of the delimiter.  
  7. Click the Choose file button to select a CSV file to import.
  8. Click Next.
 Step 3: Set up field mapping 
 

Hint: Use this step to map fields in your local file to the fields in Vtiger CRM. Fields that have the same names in the local file and CRM are mapped automatically. 

 
  1. Map Column Name in your local file to CRM Field in the CRM. 
  2. Provide a Default Value for fields.
Note: Default values are used when the value of a field is empty. In such cases, Vtiger CRM picks up the field’s default value.
  1. Click the Next button.
  2. Click the Start Import button.
  3. Click the Finish button.
    • You can click the Import More button to import more users.
 To learn more about importing records into Vtiger CRM, click here.
 

Exporting Users

Exporting is the process of transferring a copy of data from the CRM to your local computer. 
 Follow these steps to export users:
  1. Log in to your CRM account.
  2. Click the User Menu on the top right corner of the CRM screen.
  3. Click Settings.
  4. Look for the User Management section.
  5. Select Users.
  6. Click the Export button located on top of the Users page.
 All the users (active and inactive) are exported to your local computer in a .csv file. 
 

Changing CRM Account Ownership

 
Did you know?
 You can transfer the ownership of a CRM account from one user to another. 
 Why?
The account owner might be moving to a different department or leaving the company. In such situations, you would want to transfer the CRM account ownership to another user.

Follow these steps to transfer account ownership:
  1. Log in to your CRM account.
  2. Click the User Menu on the top right corner of the CRM screen.
  3. Click Settings.
  4. Look for the User Management section.
  5. Select Users.
  6. Click the Customize dropdown on the top right corner.
  7. Select the Change Owner option.
  8. Select the user to whom you want to transfer the account ownership.
  9. Click Save.
 Account owners can be identified by the icon below when you hover on their user record: 
 
Note
  • You can transfer the account ownership only if you are an Admin user. 
  • You can transfer the account ownership only to a user of type Admin.
 

Suspending a User

To suspend a user means to temporarily terminate their access to the CRM. 
 Here is what happens when you suspend a user:
  • They are marked as inactive.
  • They cannot log in to their CRM account.
  • New records cannot be assigned to them.
  • Billing will stop for the user.
 Follow these steps to suspend a user:
  1. Log in to your CRM account.
  2. Click the User Menu on the top right corner of the CRM screen.
  3. Click Settings.
  4. Look for the User Management section.
  5. Select Users.
  6. Hover on the user that you want to suspend.
  7. Click the More icon.
  8. Select the Suspend User option.
  9. Click Yes to confirm.
If the user being suspended has reportees, then you must transfer their reportees to another user. When you do this, the Reports To field in the reportees’ user records is set to the newly selected user’s name.
  1. Select a user from the Transfer Reports To user dropdown to transfer the reportees to them.
When you are suspending a user, you must transfer the records that are assigned to them to another user.
  1. Enable the Transfer all records checkbox.
  2. Choose which records you want to transfer by selecting modules from the Select modules field.
  3. Select a user from the Transfer records to this user dropdown to transfer records to them.
  4. Enable the Transfer closed records checkbox if you want to transfer closed records as well.
  5. Click Save.
 
Note: Comments, emails, and change logs are not transferred. A change log is an entry of an update made by a user to a record.


Reactivating a user

Follow these steps to reactivate a suspended user:
  1. Log in to your CRM account.
  2. Click the User Menu on the top right corner of the CRM screen.
  3. Click Settings.
  4. Look for the User Management section.
  5. Select Users.
  6. Click the Inactive Users tab. 
  7. Hover over the user that you want to reactivate.
  8. Click the More icon.
  9. Select the Reactivate User option.
  10. Click Yes to confirm.
 Records that were transferred from a suspended user to another user are not transferred back. 
 

Permanently Deleting a User 

You might want to permanently delete a user when they no longer use the CRM. However, to delete a user, you must first suspend them.
 Skip to this section to learn how to suspend a user.

 Follow these steps to delete a user after suspending them:
  1. Log in to your CRM account.
  2. Click the User Menu on the top right corner of the CRM screen.
  3. Click Settings.
  4. Look for the User Management section.
  5. Select Users.
  6. Click the Inactive Users tab. 
  7. Hover over the user that you want to delete.
  8. Click the More icon.
  9. Select the Delete user permanently option.
  10. Click Yes to confirm. 
If the user being deleted has reportees, then you must transfer their reportees to another user. When you do this, the Reports To field in the reportees’ user records is set to the newly selected user’s name.
  1. Select a user from the Transfer Reports To user dropdown to transfer the reportees to them.
When you are deleting a user, you must transfer the records that are assigned to them to another user. 
  1. Enable the Transfer all records checkbox.
  2. Choose which records you want to transfer by selecting modules from the Select modules field.
  3. Select a user from the Transfer records to this user dropdown to transfer records to them.
  4. Enable the Transfer closed records checkbox if you want to transfer closed records as well.
  5. Click Save.
 
Note: Comments, emails, and change logs are not transferred. A change log is an entry of an update made by a user to any record.
 

Troubleshooting Tips

  1. You cannot import users of type Single App and Light Agent unless there is a minimum of five Standard users in the CRM.
  2. Import fails if the User Type and Role Type information do not match. To learn about Roles in Vtiger CRM, click here.
  3. You cannot import a record (even a lead, contact, or organization) whose owner (specified in the Assigned To field) or co-owner (specified in the Co-owner field) is a user of type Light Agent.
  4. You cannot map users with Light Agent or Single App roles while importing if there are less than five Standard users.
  5. A user can report only to Standard and Admin users.
  6. Users of type Light Agent cannot have subordinate users.
  7. To change a user with a higher profile to a Light Agent user, you must transfer the records of the user to another user.
Was this article helpful?
2  out of  2  found this helpful.
Comments 0
Be the first to comment
© Copyright 2023 Vtiger. All rights reserved.