Caption text size is smaller than the recommended size for general reading. On web, it should be used only in a graph or as a timestamp for a list item. On Android and iOS, it can also be used as help text or as other kinds of secondary text for list items.


This component is no longer supported. Please use the Text component instead.

Mapping to the Text component

- <Caption>Received April 21, 2017</Caption>
+ <Text variant="bodySm" as="p">Received April 21, 2017</Text>

Best practices

  • Use for secondary labels in graphs and charts
  • May be used for timestamps in lists of content
  • Don’t use this component for other cases
  • Don’t use this component for text longer than a few words
  • Don’t use this component for aesthetic effect or to break from the standard text size

Content guidelines


Captions are primarily used in data visualizations. Stick to a few words and don’t use this component for complete sentences or longer content.


  • Use caption for labelling data visualizations Diagram of using captions to label graphs and other data content
  • Received April 21, 2017


  • Order #1001 was received on April 21, 2017
  • This is your recent activity


Follow best practices for data visualizations to ensure that the purpose of captions is clear to all merchants, including those with issues related to seeing or understanding data and complex information.