Users, Roles & Permissions

Create user accounts, define roles with granular permissions, and manage the organizational hierarchy.

June 17, 20262 min read

Roles Configuration

Navigation: Admin Console → Framework → Roles

AndroHealth Roles list screen showing Administrator Role and Care Provider roles

Creating a Role

  1. Click "New"
  2. Enter Code (auto-generate or manual), Name, and Description
  3. Set Active From/To dates
  4. Select Default Page — the landing page when a user with this role logs in
  5. Optionally copy from an existing role or import JSON
  6. Select Modules and EMR Systems this role can access
  7. In the Data Sets section, assign specific permissions:
    • Select a module from the list
    • Select components within that module
    • Check individual permissions (Create, Read, Update, Delete, View Detail, Export)
    • Or click "Assign All Roles" for full access
  8. Click "Save"
AndroHealth role permissions data sets showing Admin Console permissions with Create, Read, Update, Delete checkboxes

Permissions

Navigation: Admin Console → Framework → Permissions

Permissions has two tabs:

  • Secure Item tab — System-generated items (you cannot add new ones). You can only edit Active From/To dates and toggle status.
  • Permissions tab — Similar to Secure Items, only description and dates are editable.
AndroHealth permissions configuration showing Organization and Users permissions with selective checkboxes enabled

Creating Users

Navigation: Admin Console → Enterprise → Users

The screen shows the current user quota. Click "New" to create a user.

User Form Sections

SectionKey Fields
Basic DetailsProfile photo (5MB max), code, local name (Arabic), standard name (English), gender, DOB, nationality, National ID
User ProfileUser Type (Care Provider, Nurse, Laboratory, Non-Clinical, Assistant), qualification, license number, education, experience, certifications
Address DetailsFull address with postal code
Contact DetailsPhone, mobile (mandatory), email
Tax DetailsTax registration toggle, Tax ID, company name
OrganizationSelect organization (mandatory), position
Department"All Departments" toggle or select specific departments. Default department (mandatory)
Wards"All Wards" toggle or select specific wards (optional)
RolesSearch and assign roles. Default role (mandatory)

After saving, the system sends an email with the username and password to the user's email address.

User Types

TypeDescription
Care ProviderDoctors and primary healthcare professionals
NurseNursing staff (access to Nursing Work List)
LaboratoryLab technicians
Non-ClinicalAdministrative and support staff
AssistantCare provider assistants/interns

Positions & Organogram

Navigation: Admin Console → Enterprise → Position

Two tabs are available:

  • Position List — Create and manage positions with reporting hierarchy
  • Organogram — Visual tree view of the organizational hierarchy. Click "Vacant Positions" to see unfilled roles.

Common questions

How do I create a user account?

In Admin Console → Users, add the user and assign a role that defines their permissions.

Are permissions set per user or per role?

Permissions are defined on roles; each user inherits them from their assigned role.

Can I give one user extra permissions?

Adjust their role, or use permission overrides where supported.

Was this article helpful?

Still need help? Send a support request