Admin Role Icons - hmislk/hmis GitHub Wiki

Role Icons

Overview

Icons assigned to a role appear as visual shortcut tiles in the home screen or navigation area for all users who hold that role. Setting icons at the role level is more efficient than setting them user-by-user — one change applies to all users in the role simultaneously.

When to Use

  • Standardising the home screen for all users in a job role (e.g. all OPD cashiers see the same icon tiles)
  • Adding a new module to a role's quick-access bar
  • Removing an icon that is no longer relevant for the role

Navigating to Role Icon Management

  1. Click AdministrationManage Users
  2. Navigate to the role management area
  3. Select the role from the list
  4. Click Manage User Role Icons in the right action panel
  5. The Manage User Icons screen opens, showing the role name

Required privilege: AdminManagingUsers

Loading the Current Icon List

Click List Icon (yellow button) to load the icons currently assigned to this role. The table below populates with:

Column Description
Icon The icon name or label
Order The display order of the icon
Actions Up/down arrows to reorder; trash button to remove

Adding an Icon

  1. Select the Icon to add from the dropdown (search by name using the filter box)
  2. Click Add Icon
  3. The icon appears at the bottom of the list

Reordering Icons

Use the up arrow and down arrow buttons to change the display order. The order number updates automatically.

Removing an Icon

Click the trash icon (red button) in the Actions column to remove the icon from the role.

Related Features