Admin User Icons - hmislk/hmis GitHub Wiki
User Icons and Branding
Overview
The HMIS menu system supports custom icons assigned to users and roles. Icons are visual shortcut tiles that can appear in a user's home screen or quick-access area, providing one-click navigation to frequently used modules. This page covers assigning icons to individual users.
When to Use
- Customising a user's home screen with the modules they use most often
- Creating a streamlined interface for clinical or administrative staff who need quick access to specific pages
- Setting up a kiosk-style login for a counter with limited navigation options
Navigating to User Icons
Individual icons:
- Click Administration → Manage Users
- Select the user row
- Click Manage User Icons in the right action panel
Bulk icon management (tree view):
- Select the user row
- Click Manage User Icons (Bulk)
- A tree-based interface allows assigning multiple icons at once
Required privilege: AdminManagingUsers
Assigning Icons
On the icon management screen, select the modules or pages to show as icons for the user and save. The exact interface depends on the icon management page configuration — icons are typically shown as a selectable list or tree, and selected items appear as tiles in the user's home area.
Role Icons
Icons can also be managed at the role level, so all users sharing a role automatically get the same icon set. See Role Icons for the role-based approach.