Skip to main content
U.S. Flag

An official website of the United States government

Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

CMS Design System

    • For developers
    • Child Design Systems
    • Accessibility
    • Design Principles
    • Browser Support
    • Print guidelines
      • Layout Grid
      • Breakpoints
    • Base
      • Headings
      • Body
      • Links
      • List
    • Color
    • Spacing
    • Components overview
    • Accordion
    • Alert
    • Autocomplete
    • Badge
    • Button
    • Card (M.gov)
    • Checkbox
      • Calendar Picker
      • Multi Input Date Field
      • Single Input Date Field
    • Drawer & Help Drawer
    • Dropdown
    • Filter Chip
      • Healthcare.gov Footer
      • Medicare.gov Footer
    • Form Label & Legend
      • Healthcare.gov Header
      • Medicare.gov Header
    • Icon
    • Idle Timeout
    • Inset (HC.gov)
      • Healthcare.gov Logo
      • HHS Logo
      • Medicare.gov Logo
    • Masked Field
    • Modal Dialog
    • Month Picker
    • Pagination
    • Radio Button
    • Review
    • Skip Nav
    • Spinner
    • Stars (M.gov)
    • Step List
    • Table
    • Tabs
    • Text Field
    • Tooltip
    • USA Banner
    • Vertical Navigation
    • Patterns overview
      • Forms
      • Form validation
    • Phone numbers
    • Third Party External Link
    • Utilities overview
      • One Column Page Layout
    • Documentation Page
    • Utilities overview
    • Background Color
      • Border Radius
      • Border
    • Display
    • Flexbox
    • Float
      • Font Family
      • Font Size
      • Font Style
      • Font Weight
    • Margin
    • Overflow
    • Padding
      • Line Height
      • Measure
      • Text Alignment
      • Text Color
      • Text Decoration
      • Text Transform
      • Truncate
      • Word Break
    • Vertical Align
    • Visibility
    • Migrating to v4 buttons
    • Migrating to v2
    • Using agnostic typography classes

What's new?

View code on GitHub

HHS Logo

Renders the HHS logo.

GithubStorybook logoStorybook

  • Examples
  • Code
    • React
  • Component maturity

Have ideas?

  • Contact the team
  • Start a discussion on GitHub
  • Edit this page

Examples

Loading
Open in Storybook
Loading...
Loading...

Code

React

React Properties Documentation
NameTypeDefaultDescription
ariaHiddenbooleantrue

Describes the value of the aria-hidden attribute on the SVG. Defaulted to true with the assumption that most icons are decorative. If the icon does not have any associated label text, set this to false and ensure a title is provided for improved accessibility.

classNamestring

Additional CSS classes to be added to the svg element

childrenrequiredReact.ReactNode

The elements that make up the SVG

descriptionstring

Long-text description of any SVG. Use for complex icons, otherwise title prop will suffice.

idstring

A custom id attribute for the SVG

inversedbooleanfalse

If true sets inverse fill color.

titlerequiredstring

The descriptive name for the SVG icon

viewBoxstring

A string describing the viewbox of the SVG.

It is recommended that the icon is centered and fill up the default viewport size. See this blog post for further explanation on viewBox and how to use it.

Component maturity

For more information about how we tested and validated our work for each checklist item, read our component maturity documentation.

Accessibility

  • Color

    Meets AA color contrast standards for accessibility and color blindness.
    Complete
  • Forced Colors Mode (FCM)

    While using FCM the components text is legible and improves readability.
    Incomplete
  • WCAG 2.1 Level AA Conformance

    All Axe checks for WCAG AA compliance have passed.
    Complete
  • Screen readers

    VoiceOver, NVDA, and JAWS screen readers provide concise communication and interaction.
    Complete
  • Keyboard navigation

    Component is fully navigable with a keyboard.
    Complete

Code

  • Storybook

    Component has stories to cover all defined props.
    Complete
  • Responsive

    Component designed to work in all responsive breakpoints.
    Complete
  • Spanish translations

    Includes Spanish translations for default text content.
    Complete

Tokens

  • Code

    Tokens implemented in code.
    Complete
  • Design

    Tokens implemented in the Sketch.
    Complete

On this page

  • Examples
  • Code
    • React
  • Component maturity

Have ideas?

  • Contact the team
  • Start a discussion on GitHub
  • Edit this page
Plain WritingPrivacy PolicyU.S. Web Design System

A federal government website managed by the Centers for Medicare & Medicaid Services 7500 Security Boulevard, Baltimore, MD 21124