What this module does
The Upendo Image Gallery Manager is the staff workspace for building an image library. Authorized staff can upload images, add descriptions and location information, group images with categories and tags, publish or hide assets, and replace image files without losing their records.
The related viewer module displays published images on a public page. Visitors do not use the Manager screen.
Who can use it
The manager supports several levels of access:
- Superusers can manage all portal images and open the superuser configuration.
- Administrators, Site Admins, and Upendo Clients are treated as elevated users when the deployment’s role setup includes them. They can manage images according to the module rules, but they cannot open the superuser configuration.
- General content editors can manage their own images. They see My Images instead of the full library when the all-images capability is not available.
Some category and tag actions depend on the settings chosen by a superuser. If a button is missing, your account or the module settings do not allow that action.
Main screen
The Media Library lets you:
- Search by title, owner, location, or other metadata.
- Filter by category, tag, and status.
- Sort by newest, oldest, or title.
- Switch between All Images and My Images when permitted.
- Open an image to edit it.
- Upload a new asset.
- Archive an asset so it is no longer part of normal published output.
The normal statuses are Published, Drafts, and Archived. Draft images stay hidden from public gallery output. Archived images are removed from normal published output but remain in the library.
An image can have a title, description, location name, location address, one category, and up to five tags. The title and description are required. A location address can be typed manually or selected from OpenStreetMap suggestions. Selecting a suggestion is optional; the typed address can still be saved.
Uploads and files
The upload panel accepts common image files such as JPG, PNG, WebP, GIF, HEIC, and HEIF. SVG uploads are blocked for security. Upload limits and image sizes are controlled by superuser configuration.
The system creates image versions for display, thumbnails, and lightboxes when those sizes are enabled. Replacing a file keeps the gallery record and its title, description, category, tags, and location information.
Categories are broad groups, such as Events or Members. Tags are short keywords that describe an image. Keep category names stable and use tags consistently so the viewer’s filters remain useful.
Elevated users can manage categories when the setting Allow elevated users to create categories is enabled. Users can create tags when Allow users to create tags is enabled. Category changes may include create, edit, archive, restore, and reorder actions.
Privacy and quality
Do not upload an image unless your organization has permission to use it. Avoid placing private information in titles, descriptions, or locations. Use clear titles and descriptions because the viewer may show them to visitors and search systems.
Superuser configuration
Only superusers can open Image Gallery Superuser Config. The settings include the maximum upload size, maximum image width and height, display, thumbnail, and lightbox sizes, whether users can create tags, and the default publishing status. Changing these settings affects how this manager and its image files behave.