Creating and editing users

Managing users effectively is key to a seamless experience on your platform. This guide walks you through understanding the set-up of user management, how to create new users, and best practices.

1. What is user management?
 

User management is the process of creating, managing, and overseeing accounts for individuals accessing your platform. It ensures that users have appropriate roles, permissions, and access based on their needs.

In your software, user management involves:

  • Adding new users individually or in bulk.
  • Assigning roles (such as Admin, Guru, or Collaborator) to regulate access and functionality. 
  • Organizing users into groups for dashboard publication and survey access.

2. Why do you need user management?
 

Security and accessibility
Proper user management protects sensitive data and ensures that users only access the information and features relevant to their roles.

Operational efficiency
By categorizing users into roles and groups, you streamline project collaboration, audits, and reporting, saving time and reducing unclarity.

Customized functionality
With defined roles and permissions, users receive a tailored experience, whether they’re managing data, conducting surveys, or viewing dashboards.


3. How to create and edit users
 

Adding a single user

  1. Navigate to Management > Users & Groups from the main menu.
  2. Click the Add User button.
  3. In the pop-up, complete (at least) the mandatory fields (marked with asterisks) such as:
    • User Type: Admin, Guru or Collaborator (see paragraph 4 for more detailed information regarding these types).
    • First Name and Email Address.
    • Role
  4. Ensure the email address is unique (no duplicates allowed).
  5. Click Add to create the user.

If you try to add more users then your contract allows, the new user will not be created and you will see a notification message that you have reached the maximum amount. You can upgrade your contract through support to gain more user spaces.

Once the user is created, they appear in the list with a Pending status. Send them an activation email to let them know an account has been created for them:

  • Select the user(s) from the list.
  • Click Action > Send Activation Email.
  • Confirm your action to send the email.

The user can activate their account and gain access to the platform.

Bulk importing users

Creating users through an import file is a great way to quickly create larger amounts of users at once. 

  1. Prepare an Excel file with the required columns: First name, Last name, E-mail, Type, Group and Role.
    • You can download a template CSV or Excel file from the Import pop-up that appears when you click the Import option.
  2. Ensure your data is correctly formatted:
    • Take care your spelling is exact and pay attention to capitals/lowercase letters.
  3. Go to Users & Groups > Import and upload the file.
  4. Once the import is processed, review the system-generated summary file to confirm the successful addition of users.

Editing users

You can easily change the settings for existing users to stay up to date with company changes. For example changing the user type or assigned role. Any changes made will take effect immediately.

  1. Click on the user name.
  2. In the pop-up, make the necessary changes (e.g. updating Groups or changing the assigned User type or Role).
    • Please note that the email address can never be edited as it is the unique identifier by which the user account is recognized.
  3. Click update to save the changes you made.

4. Roles and groups
 

Roles
It is required to assign a role to a user account, in order to define which functionalities the user has access to. There are already default roles available for each of the user types, which can be customized to your specific needs if required. 

  • Assign roles to define what a user can view, edit, or manage.
  • Standard roles include:
    • Admin: Full access to create and manage projects, dashboards, reports.
    • Guru: Same access as an admin, with the addition of specialized functionality, such as API management or coding.
    • Collaborator: Access for viewing dashboards, reports or filling out surveys that are published to them.

Custom roles can be created for unique requirements by navigating to the Roles tab. This tab also gives a more detailed insight in the access levels per role.

Groups
Groups can be used to simplify the publication of dashboards or surveys, so you are able to quickly provide the correct access. This ensures that publications don’t need to be managed for each individual user. Simply assign a user to a group, and all relevant publications are automatically applied.

  • Organize users into groups, for examply by project, region, language or organization level.
  • Users can be added to multiple groups if needed.
  • Groups ensure data relevance and targeted communication.

Groups and their structure can be created and managed via the Groups tab.


5. Best practices for managing users
 

  1. Set clear role definitions
    Choose roles aligned with a user’s responsibilities to avoid granting unnecessary access.
     
  2. Leverage groups
    Use clear groups to tailor the information users see and to simplify user management to your company structure.
     
  3. Plan bulk imports carefully
    Double-check your Excel file formatting before uploading.
     
  4. Update and check regularly
    Periodically review users' roles, groups, and access rights to ensure compliance with organizational changes.
     
  5. Utilize custom roles thoughtfully
    Custom roles should address specific business needs not met by default roles.

6. Important checks
 

  1. Assigning account based filters
    When placing (new) users in a group, always take into consideration the dashboards they now have access to. If there are any account based filters placed on these dashboards, you will need to set them up for the newly added user as well.
     
  2. Updating Role Based Push Reports
    Any Reports that are periodically created and sent to your users have a user-based recipient list instead of grouped lists, in order to support optimal personalization. If the new users should receive these reports, you will need to update the recipient lists accordingly.


By following these steps and best practices, you can efficiently onboard new users and manage their experience within your platform. For further assistance, consult the user management support documents or contact your portal Administrator.