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:

  1. Click AdministrationManage Users
  2. Select the user row
  3. Click Manage User Icons in the right action panel

Bulk icon management (tree view):

  1. Select the user row
  2. Click Manage User Icons (Bulk)
  3. 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.

Related Features