> ## Documentation Index > Fetch the complete documentation index at: https://docs.kayanos.com/llms.txt > Use this file to discover all available pages before exploring further. # Homepage > Configure organization Home hero images and help members manage launcher-first personal shortcuts without confusing presentation with access. 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**. 1. 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. 2. Select the light and/or dark file and review its local preview. 3. Choose the background position and size that keep headings, search, shortcuts, and header controls readable on wide and narrow screens. 4. Save once and wait for the success result. Upload and settings persistence are one guarded operation; if it fails, review the message before retrying. 5. 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: 1. Open **Apps** or launcher search. 2. Star an available application, application page, or utility. 3. Return to Home and confirm it appears in the shortcuts area. More favorites can be available than fit in the first row. 4. 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 | ## Related guides * Use the launcher and favorites in [Navigate KayanOS](/start/navigate-kayanos). * Work from Home in [Home and notifications](/work/home-and-notifications). * Review organization presentation in [Organization settings](/admin/organization-settings). * Diagnose resource access in [Roles and scopes](/admin/roles-and-scopes). ![KayanOS Homepage settings for the Directorate of Citizen Services.](https://kayanos.app/docs-images/en/admin/homepage.png)