Media Gallery

Purpose of the 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.

Media Gallery Component in page 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 goalUse 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.

Elements of a Media Gallery

 

ElementPurpose
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

 

FeaturesStandards
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