Documentation Knowledgebase

This area helps us show you how to use our features to grow your business.

Image Gallery Viewer

Upendo Image Gallery Viewer

The Upendo Image Gallery Viewer displays published gallery images on a page as a grid or related-images block; staff control the template, filters, paging, headings, sorting, and card styling in the module settings.

Updated

What this module does

The Upendo Image Gallery Viewer displays published gallery images on a website page. It can show a normal image grid or related images, with optional headings, descriptions, categories, tags, filters, and page controls.

Visitors use the viewer. Staff configure it through the module settings. The viewer does not show Draft or Archived assets in normal public output.

What visitors can see

Depending on the page settings and template, visitors may see:

  • A gallery heading, subheading, and introduction.
  • Image cards with titles, descriptions, tags, or location details.
  • Category and tag filter controls.
  • A More filter menu when there are many filters.
  • Paging controls.
  • A related-images view instead of the full gallery.
  • An empty message when no published images match.

The viewer reads category and tag filters from the page setup or the page query string when fixed filters are not selected. Search and page values are limited and cleaned before use.

Module settings

Staff with permission to edit the page or module can open its settings. Settings include:

  • Widget View: Gallery Grid or Related Images.
  • Template: The file-based template set used for the output.
  • Page Size and Cards Per Row.
  • Max Visible Filters.
  • Sort By: Newest, Oldest, or Title.
  • Show Description.
  • Fixed category and tag filters.
  • Heading, subheading, and intro text.
  • Text alignment and HTML heading tags.
  • Card border, background color, corner style, border radius, and image height.

Content rules

Only Published assets are part of normal public gallery output. The Manager controls the image records; this Viewer controls how those records appear on a page.

Choose meaningful headings and descriptions for visitors. Use fixed filters when the page should always show one group. Leave fixed filters empty when visitors should be able to use query-string filtering.

Accessibility and page quality

Use a sensible heading order and readable colors. Keep image titles and descriptions clear. Avoid showing too many filters at once; use the More option when the filter list is long.