Users can be onboarded to the system through two methods:

• Individual Email Addresses:Add users one-by-one by entering their email addresses. This approach is suitable for onboarding a small number of users.
• Bulk User Import: Add multiple users at once by uploading a CSV file containing user details.This method is efficient for onboarding a large number of users.

A user can also be part of multiple organizations. Adding users to each organization follows the same process as adding single or bulk users to an individual organization.

Add users

Prerequisites

• CAP POC: Ensure a CAP POC is set for the organization. To set, navigate to Organization setings > Organization Setup > Organization Profile > Organization POC. This is required to send an email to set a password for the user.

• Roles Definition: Define the role of the organization. The roles below should be present in small cases.
  Note: The case sensitivity in the org roles will be removed in future releases.
  • Org Level - Access to the entire organization-level data.
  • Store Level - Access only to store-level data
  • Zone Level - Access only to a zone level data
  • Concept Level - Access only to concept-level data

Using individual email addresses

This feature enables you to add users by entering their email IDs. All email addresses will receive the same level of permissions chosen in this process. A maximum of 10 emails can be added at once. For adding more users, the bulk user upload feature is available to create users in bulk efficiently.

Perform the following:

🚧

Note

• Admin access required
• You need to have org access to add the users.

1. Click Add new user.

2. Select Add with email addresses and click Continue.

3. Enter the email addresses one by one in this text box and click "enter" on your keyboard after typing each email. A maximum of 10 emails can be added.

4. Select the User Type and click Continue. Please note that it is mandatory to assign a user type to each user.

5. For Standard users - Select the entities to which you want to give access for those user(s) and click Continue. You can give access to the entire Organization or certain Org units or Stores.
   Note: Organization owners will have access to the entire org by default, and hence there is no need to select any entity for an Org owner.

6. (Applicable for Standard users) Choose the relevant permission set or you could also create a new permission set and click Continue.
   Org owners will have full authority, so there is no need to select any permission set for an org owner.

10. Click Send invite.

Once the Send Invite button is clicked, an email is triggered to the user's email address to set the user password. If the automatic email delivery fails or the user has not received the email, you can copy the invite link and send it manually. For information on password requirements, refer to documentation on the password requirements.

Adding bulk users

You can use the bulk-upload option to add users in bulk. With the bulk upload, you can have different permissions mapped to different users. A maximum of 200 users can be added using bulk upload.

To add the users in bulk, perform the following:

1. Click Add new user.

2. Select the bulk upload option.

3. Upload the CSV file. You can download the sample file, enter the values, and you can upload the same file. You can have multiple people on this list, and can also have different permissions for each person. So that way, you can customize permission for different users through this bulk upload flow.

   email	Email ID of the user
   userRole	A designation of the user. For example, admin.
   groupName	If applicable, the user group to which the user is associated with.
   title	Title of the user. For example, Mr, Miss.
   firstName	First name of the user
   middleName	Middle name of the user
   lastName	Last name of the user
   mobile	Mobile number of the user
   accessibleEntities	Entities to which the user will have access. Organization, Org units/Concepts, Stores, Zones.
   userType	The user type. Standard or Org owner.

4. Click Create user(s). An email will be sent to the registered user to set the user password. If the automatic email delivery fails or the user has not received the email, you can copy the invite link and send it manually. For information on password requirements, refer to documentation on the password requirements.

Sending user registration invite link manually

If the automatic email notification fails to send, you can manually send the registration invite link to the user. Follow these steps:

1. Navigate to the User List page.
2. Locate the user's row and click the kebab menu (⋮).
3. Select the Copy invite link from the menu options.

Once you have copied the link, you can:

• Send it to the user through your preferred communication channel
• Verify the link by pasting it in a browser - it should direct to the password reset page for that user

**Note: **When the user clicks this link, they will be taken to a password reset page to complete their registration

🚧

Note

The invite link is valid for 24 hours from the time it was created. You can create a new invite link and share with the user.

Password requirements

The password set by users must adhere to the following guidelines:

Password complexity requirements

• Minimum length of 9 characters
• Includes at least:
  • one uppercase letter
  • one numeric digit
  • 1=one special character (e.g., !, @, #, $)
• Cannot be the same as the user's username

Password history restrictions

• Cannot match any of the user's last 4 previously used passwords

View users

You can view the user list on the Onboarding users' homepage. You can also export the users' list. The users list includes the following details:

• Name and Email address of the user
• User type
• Status
  • Active indicates that the user is active
  • Pending indicates that the user has received the invite to join the organization but has not joined
  • Deactivated indicates that the user is deactivated.

Note: User status filter applies to both proxy and original users.

Export users list

You can export the present users' list of the org in a CSV format. The CSV file contains the following details:

• First name
• Last name
• Email address
• Mobile
• Status
• Created on
• Created by
• Last login
• Is cap tech user - Indicates if the user is a capillary tech user. This is identified using the email address of the user.

Note- If proxy users are included in the list, they will also appear in the export.

Update users

You can update the users one by one or in bulk.

Updating users individually

To edit a single user,

1. Navigate to the User List page.
2. Locate the user's row and click the kebab menu (⋮).
3. Select Edit.
4. Make the required changes and click Save Changes.

Updating users in bulk

1. Select the **Bulk update users **option from the user listing page:

2. Upload file with relevant fields to update user details:

3. Click Done.

Note: Updating user permissions will append or add to the existing permissions.

Delete users

If you are an organization owner, you can delete users from the User Management UI. There are two ways to delete a user:

• Select individual users from the UI
• Upload a CSV file for bulk deletion

Deleting users from the UI

You can remove users individually or multiple users together by selecting 1 or many user(s) from the user list available on UI. To remove it, on the user listing page, select the user and click Remove from organization.

Deleting users in bulk

You can delete multiple users at once by uploading a CSV file from the User Management UI. The CSV file contains the email IDs of the users to be deleted. Before any users are deleted, the system validates the uploaded file and each record to ensure that only the intended users are removed.

❗️

Once the users are deleted, they cannot be recovered.

Pre-requisites

• You must have a CSV file that contains the email addresses of the users to be deleted. Make sure that the CSV file has the following:
  • Header - The file must contain the header Email.
  • Valid email ID - The file must contain valid email IDs of users. If the format of the mail ID is incorrect, an error occurs.
  • No duplicate entries - The file must not contain duplicate entries of the email IDs. If there are any duplicate entries, the validation fails, and no users are deleted.

Sample CSV format

Email
[email protected]
[email protected]
[email protected]

You can proceed with deleting users in bulk.

📘

Note

• One organization owner can delete another organization owner.
• You cannot delete your own user ID.

Steps to delete users in bulk

To delete users in bulk, perform the following:

1. In the User Management UI, hover over More actions.
   The actions menu appears.

   

2. Select Bulk remove users.
   The bulk removal page opens.

   

3. Upload the CSV file by dragging it into the upload area or selecting it from your system.
   Note: The file can contain up to 50 rows. Files exceeding this limit are rejected.
   The system validates the contents of the CSV file.

4. Review the validation results and proceed with deletion if the CSV contains only valid entries. The system generates an error.csv file in the following scenarios:

   1. If the CSV file contains only invalid entries
   2. If the CSV file contains a mix of valid and invalid entries. In this scenario, you can continue and delete only the users whose entries passed validation

   The file lists each invalid email address and the reason for the failure. Click Download error file to review the issues.

Sample error.csv

Email,Error
[email protected],User not found in organization
[email protected],User not found in organization
[email protected],User not found in organization

4. Click Remove users to delete the valid users.
   A confirmation modal appears showing the number of valid users that will be deleted.

   

5. Click Yes, remove to proceed.

After you confirm the deletion request, the system deletes each validated user based on whether the user was created in the current organization or has only proxy access.

Deleting users with multiple-organization access

Some users belong to multiple organizations. After you confirm the deletion request, the system determines how each user should be removed based on how the user is associated with the current organization. The deletion behavior depends on whether the user is being removed from their base organization or from an organization where they have proxy access.

Deleting a user from a proxy organization

If the user was not created in the current organization and only has proxy access:

• The user is not fully deleted.

• Only the proxy access for the current organization is removed.

• The user remains active in their base organization and in any other organizations where they have access.

Deleting a user from the base organization

If the user was created in the current organization, then the current organization is the user’s base organization:

• The user is fully deleted from the system.

• All proxy accesses to other organizations are also removed automatically.

Example

User A was created in Organization X, base organization and has proxy access to Organizations Y and Z.

• If User A is deleted from Organization Y, only their proxy access to Y is removed. User A continues to exist in X and Z.

• If User A is deleted from Organization X, User A is removed from X, Y, and Z.