Skip to main content

Style Guide

Welcome to the Medicaid.gov (MED) Style Guide

This guide is your central resource for creating consistent, accessible and user-friendly digital experiences for the families and partners interacting with Medicaid.gov. Think of it as the foundation for our shared visual and interactive language, helping us build trust and deliver information effectively. It brings together our principles, standards and tools to support designers, developers, content creators and anyone involved in building Medicaid’s digital presence.

Why Use the Medicaid Style Guide?

Consistency matters, and so does clarity. By using this guide, we ensure that every interaction with Medicaid online feels familiar, reliable, and easy to navigate. It helps us speak with one voice, visually and textually. Adhering to these standards allows us to:

  • Build Trust: Create a unified and professional Medicaid brand experience across all digital touch points.
  • Ensure Accessibility: Meet and exceed Section 508 compliance requirements, making our services usable for everyone.
  • Improve Usability: Provide intuitive interfaces and clear content that helps our users find the information they need quickly and easily.
  • Increase Efficiency: Streamline design and development workflows by providing reusable components, patterns and clear guidance.

What You'll Find Inside

Logo

Medicaid.gov Logo

Colors

Typography

Government websites need clear and consistent headings, highly legible body paragraphs, clear labels, and easy-to-use input fields. Our default typefaces are designed for legibility and can adapt to a variety of visual tones.

Button

Primary Button

This guide is organized to provide easy access to the core elements you need:

  • Guiding Principles: The fundamental ideas that shape our design decisions, focusing on user needs, accessibility, and clarity.
  • Visual Foundation: Guidance on using the Medicaid color palette, typography, logos, and spacing to create a cohesive look and feel.
  • UI Components & Patterns: A library of reusable interface elements (like buttons, forms, and navigation) with code snippets and usage guidelines to ensure consistency.
  • Content Style Guide: Standards for voice, tone, grammar, and specific terminology relevant to Medicaid, ensuring our communication is clear, compassionate, and consistent.
  • Accessibility Standards: Practical guidance and best practices for creating accessible content and interfaces from the start.

Getting Started

Ready to dive in? Here’s how different roles can best use the guide:

  • Designers: Explore the Visual Foundation and UI Components sections.
  • Developers: Head to the Components or Patterns section for code implementation details. Find instructions for integrating styles and components into your projects.
  • Content Creators: Familiarize yourself with the style guide to ensure your writing aligns with the Medicaid voice and tone.

Building on Solid Ground

We aim to follow best practices in web design and development. Where appropriate, our standards align with or build upon established systems like the U.S. Web Design System (USWDS) to ensure robust, compliant and effective digital solutions for Medicaid.