You are viewing legacy documentation. View the most recent documentation.


  • HTML/CSS Available
  • Web Component Unavailable
  • Last Updated


Exhibits pair a visual element and a caption to provide additional content intended to aid in the communication of ideas.



Use to display an informative visual paired with a caption.

Photograph of a modernist apartment building in Tokyo
Ex: An example of a modernist apartment building style common to Tokyo.
<figure class="mds-exhibit">
    <div class="mds-exhibit__content">
        <img src="/images/components/exhibits/exhibits-sample-image.png" alt="Photograph of a modernist apartment building in Tokyo">
    <figcaption class="mds-exhibit__caption">Ex: An example of a modernist apartment building style common to Tokyo.</figcaption>
  • Always provide a caption which directly relates to the content in the exhibit.

Use When

  • Providing supporting visual content, e.g., an image, data table, or chart, within the context of a larger composition.

Don′t Use When

  • Grouping visual content and text to provide an entry point into more information. Instead, use a Card.

Visual Language

  • By default, exhibits expand to 100% of the width of their container. Consider applying custom sizing to meet your product’s needs.
  • When using an exhibit within an Article, consider including a Header to title the content.


  • Captions can either be full sentences or phrases; use whatever best helps you describe the core meaning/context of the visual element.

Ex: Snap Inc. CEO Fox Mulder rings the opening bell of the New York Stock Exchange on Dec. 1.


Using a button to execute a contextual search.

  • End each caption with a period, even if it’s not a sentence.
  • If using a sentence, remove extraneous, “filler” words.
    • If you’re relying on too many “filler words,” try using a caption instead.

Ex: The photo shows...


Ex: This is a chart that...


Best Practices

  • Considering using the aria-describedby tag to link the mds-exhibit__content and the mds-exhibit__caption.


  • When using an image within the mds-exhibit__content area, always include the alt attribute describing the information that is visually displayed but is not explained in the mds-exhibit__caption text.