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
- Click Administration → Manage Users
- Navigate to the role management area
- Select the role from the list
- Click Manage User Role Icons in the right action panel
- 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
- Select the Icon to add from the dropdown (search by name using the filter box)
- Click Add Icon
- 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.