Homepage - KayanOS Documentation

Home is now a launcher-first personal starting point. It can combine search, task context, applications, recent destinations, and shortcuts that the current member starred. The organization controls approved Home hero images; it does not publish an organization-wide shortcut layout that overwrites every member’s favorites. For the Directorate of Citizen Services, use organization imagery to make the active tenant recognizable and let each Registry Officer or Service Manager star the destinations they actually use. Neither an image nor a favorite grants access to the linked resource.

Goal

Configure safe light/dark Home hero images, explain the boundary between organization presentation and personal shortcuts, and validate the result across roles, languages, themes, and screen sizes.

Current configuration model

Layer	Who controls it	Effect
Organization hero	Authorized organization administrator	Supplies approved light/dark imagery and its position/size for the organization Home
Member favorites	Individual member	Stars available applications, pages, and launcher utilities for that member in the active organization
Current availability	KayanOS permissions and configuration	Filters applications, pages, commands, and utilities at use time

The former organization Homepage layout editor is not the current model. Do not instruct administrators to publish or reset a shared widget grid. Home shortcuts come from each member’s favorites; changing hero imagery does not change those favorites.

Configure organization hero images

Open Administration → Organization settings and find Homepage hero images.

Prepare separate approved light and dark images when both themes are supported. Use ordinary image files within the size limit shown by the control; do not upload a dashboard screenshot, citizen document, staff export, credential, or case photo.
Select the light and/or dark file and review its local preview.
Choose the background position and size that keep headings, search, shortcuts, and header controls readable on wide and narrow screens.
Save once and wait for the success result. Upload and settings persistence are one guarded operation; if it fails, review the message before retrying.
Use Remove for one theme when that image should no longer be used, or Reset only when the organization has approved returning both hero settings to their defaults.

Hero uploads are scoped to the active organization. Reconfirm the organization identity before saving, especially when an administrator manages more than one tenant.

Manage personal Home shortcuts

Members manage their own shortcuts from Home or the launcher:

Open Apps or launcher search.
Star an available application, application page, or utility.
Return to Home and confirm it appears in the shortcuts area. More favorites can be available than fit in the first row.
Unstar it to remove the personal shortcut.

Favorites follow the member within the active organization and do not become shared navigation. A retired or newly unavailable destination is omitted safely. Do not broaden a role merely to restore an old favorite.

Validate safely

Check	Expected result
Light and dark theme	The matching approved hero appears and all text/actions remain legible
English and Arabic	Header, hero, search, and shortcuts keep correct direction and alignment
Narrow screen	Search and essential header utilities remain reachable without covering content
Two organizations	A saved hero affects only the organization selected when it was saved
Two members	Each member keeps a separate favorites list
Restricted favorite	The shortcut is absent or denied according to current access; it never restores permission

Use synthetic work and controlled accounts. A visual check does not replace testing the target page’s list/open/update permissions.

Troubleshooting

Symptom	Check first	Safe response
Hero does not save	Organization authority, file type/size, active organization, and upload error	Correct the smallest failing input and retry once
Wrong image appears	Current organization, light/dark theme, saved URL, and browser refresh	Reopen Organization settings before replacing an image
Text is hard to read	Image contrast, position, size, and both themes	Remove or replace the image with an approved accessible asset
Shortcut is missing	Member organization, star state, destination publication, and current access	Re-star an available destination; do not grant broad access
Old instructions mention a shared layout	They refer to the retired organization Homepage layout editor	Use organization hero settings plus per-member favorites

Use the launcher and favorites in Navigate KayanOS.
Work from Home in Home and notifications.
Review organization presentation in Organization settings.
Diagnose resource access in Roles and scopes.

KayanOS Homepage settings for the Directorate of Citizen Services.

​Goal

​Current configuration model

​Configure organization hero images

​Manage personal Home shortcuts

​Validate safely

​Troubleshooting

​Related guides