Media Gallery
Display a collection of images or media for visual browsing
This component supports storytelling and exploration by presenting multiple visual assets in a structured gallery layout.
Example page context showing where a Media Gallery is typically used
✓ Use this component when:
- You have multiple related images or media assets
- Visual content is central to the page’s purpose
- Users benefit from browsing or viewing media sequentially
- Images provide meaningful context or documentation
✕ Avoid using this component when:
- A single image is sufficient (use Image instead)
- Images are decorative and not content-bearing
- Users must read detailed text alongside each item
- The page requires dense or task-focused layout
Choosing Between Similar Components
If your goal is…
| Your goal | Use this component |
|---|---|
Display multiple images for browsing | Media Gallery |
Show a single image | Image |
Feature one story, event, or initiative | 50/50 Card |
Provide quick links or actions | Button-Style Cards |
Media Gallery Overview
A Media Gallery component displays a curated collection of media items (images, audio, video, or externally hosted media). Media Galleries help highlight visual stories, showcase collections, or present multiple related assets in one place.
Example: Showcasing exhibit photography
This example shows a Media Gallery used to present event photography, allowing users to browse images within a cohesive visual collection.
Elements of a Media Gallery
| Element | Purpose |
|---|---|
Heading | Provides the title for the media item |
Media item | Shows a preview that users can select to view larger |
Caption | Adds brief context or credit below the media in full-screen view |
Media grid | Displays all gallery items in a browsable grid |
Full-screen view | Shows a larger version of the selected media item |
Modal navigation | Lets users move between media items in full-screen view |
Guidance on using a Media Gallery
- Use to showcase visual collections. Add a Media Gallery when users benefit from seeing multiple related images or media items together.
- Support exploration. Present media in a clear grid layout so users can quickly browse and discover items of interest.
- Enable focused viewing. Full-screen view allows users to examine details without distraction; encourage use of high-resolution media.
- Write concise, meaningful captions. Use captions to provide context or credit that helps users interpret the media.
- Ensure accessible descriptions. Provide accurate alternative text for each media item to support nonvisual users.
- Avoid overload. Include only the most relevant media and keep galleries at a manageable size for easy scanning.
Content guidelines
Ensure image quality
Use high-resolution images appropriate for display size.
Avoid redundant imagery
Do not include multiple images that convey the same information.
Write concise captions
Keep captions short and informative.
Accessibility considerations
- Provide descriptive alternative text for all meaningful images
- Ensure navigation controls are keyboard accessible
- Avoid using images that contain critical text without alternatives
- Maintain sufficient contrast for captions
Media Gallery features
| Features | Standards |
|---|---|
Images displayed in a consistent grid layout | Minimum Contrast |
Left-aligned headings and text | Text Block Alignment |
Background color, icons, and underlining used to indicate links | Link Indicators |
Full-screen modal supports keyboard navigation and logical focus order | Focus Order |
Media Gallery Showcase
This example shows the Media Gallery component set to display a collections of images