Gallery
Use the gallery when you need slideshows, grids, or lightbox galleries from DAM images.
Live demo
Visitors browse visual sets (events, spaces, portfolios) without leaving the page. Content authors pick the gallery type and which assets to include; visual designers align the pattern with page rhythm (hero strip versus dense grid). Empty or missing assets should be handled gracefully in authoring.
Behaviour
- The type controls which layout and scripts load (slideshow, photo grid, light gallery).
- Folders under DAM may expand to child image assets up to max per page limits.
- When no images resolve, the component shows an empty state in authoring.
Anatomy
- Outer shell for the chosen gallery type.
- Items (slides, thumbs, or grid cells).
- Navigation controls that depend on the type (arrows, lightbox triggers).
Replace with slideshow and grid examples.
Content guidelines
- Prefer consistent aspect ratios in DAM for cleaner grids.
- Provide captions in the type that supports them.
Best practices
Do
- Set max per page when pointing at large folders to protect performance.
Don't
- Don't point at huge folders without maxPerPage; it affects performance.
When to use
- Photo sets, event galleries, or lightbox browsing when DAM assets are ready.
When not to use
- Single image; use Image.
- Carousel of arbitrary components; use Carousel multi items.
CRXDE Lite query
Use this query in CRXDE Lite to find instances of this component.
/jcr:root/content//*[@sling:resourceType = 'concordia/components/gallery/gallery.jsp']Technical behaviour
gallery.jsp parses the images multifield JSON (imagePath, link, etc.). Paths under /content/dam may point to folders; the script iterates child assets and filters dc:format to image types. maxPerPage limits visible items. empty.jsp handles no-content states.
Authoring fields
| Field | Purpose |
|---|---|
| Gallery type | Chooses script branch and behaviour. |
| Images | Multifield of assets or folders. |
| Max per page | Pagination or cap. |
Instances in the codebase
| Location | Notes |
|---|---|
apps/concordia/components/gallery/gallery.jsp |
Router and asset collection. |
type_.jsp, listitem_.jsp |
Per-type markup. |
empty.jsp |
Placeholder. |
| Item | Location |
|---|---|
| Main | apps/concordia/components/gallery/gallery.jsp |