Accessibility on VA.gov

Last Updated: February 24, 2025

This purpose of this page is to help researchers, designers, and developers working within OCTO understand how Veterans Affairs (VA) approaches accessibility. The page is a useful, evolving resource for new and existing VA accessibility specialists to understand the context of their work and how to get help.

Please note, this page contains guidelines, not mandates. By following these guidelines, it helps to ensure your team launches products that meet the VA’s vision:

Our Mission

VA is here to serve American veterans, of whom approximately 40% have an identified disability. Our mission is to empower product teams to collaborate with disabled Veterans and caregivers by enhancing the culture and tools used to co-create and maintain services that are accessible beyond compliance. 

Strategy and Standards

• Learn more about our accessibility strategy.

• Find out what experience standards a VA.gov product needs to meet before it launches.

  • Our standards are informed by the Web Content Accessibility Guidelines (WCAG).

  • Components in the VA Design System document accessibility considerations.

• The accessibility defect severity rubric is our common language for determining the seriousness of an accessibility issue.

We aim to:

• Follow inclusive design best practices in all of our work.

• Do more than pass a Section 508 audit. While we need to meet the official federal government accessibility baseline, we focus on usability, not just compliance.

• “Shift left," integrating accessibility practices across research, design, and development disciplines, starting as early in the product cycle as possible.

Accessibility Resources by Discipline

We are all responsible for the accessibility of our products, and every discipline has a role.

Resources for Researchers

The best way to ensure that a product is accessible is to test it with users of assistive technology. Designing for complex needs first - like aging Veterans above the age of 55 or Veterans with disabilities - means designing for the future of all Veterans who age or acquire disabilities later in life. (Learn about inclusive research practices.)

Get help

The Accessibility Digital Experience (ADE) team can support your inclusive research sessions by:

• Reviewing your research plan

• Conducting a pilot session with an ADE accessibility specialist (recommended) before running your research sessions to mitigate any potential accessibility-related issues.

• Providing technical support during sessions with assistive technology (AT) users

• Observing sessions with AT users from an accessibility point of view and providing findings

• Submitting an AT Research Support Ticket with ADE to get started.

Recruiting participants

• Use the MVS sampling method to recruit participants that use assistive technology.

• Include mobile participants, or have a separate study for mobile usability testing.

• Read more about inclusive recruitment strategies.

Preparing prototypes for assistive technology users

• Review the types of assistive technologies and how to modify your prototypes.

• Consider creating your prototype in CodePen or Codespaces for the most accurate results.

Research sessions

• Read the VA guide to research with assistive technology users.

• Follow the screen reader checklist.

• Learn how to be respectful of participants with disabilities.

Resources for Designers

Creating visual designs with accessibility in mind goes a long way in making your end product accessible to all Veterans.

Apply accessibility best practices

When designing an interface, follow these best practices:

• Provide sufficient contrast between foreground and background

• Don’t use color alone to convey information

• Ensure that interactive elements are easy to identify

• Provide clear and consistent navigation options

• Ensure that form elements include clearly associated labels

• Provide easily identifiable feedback

• Use headings and spacing to group related content

• Create designs for different viewport sizes

• Include image and media alternatives in your design

• Provide controls for content that starts automatically

Use VA Design System components

Don't re-create the wheel! The VA Design System (VADS) is here to help. VADS components are well-documented and have been reviewed for accessibility issues. Whenever possible, default to using an existing component or pattern in your designs. Check out the VA Design System components Figma library

Designing a form? Use the VA common form pattern templates in Figma.

Use accessibility annotations

A lot can be lost in translation when handing off your designs to a developer. Use accessibility annotations to make your intentions clear. It's especially important to annotate information that is semantically important, but not obvious on visual inspection:

• Heading levels (H1, H2, etc.)

• Anything that's using non-default styling (for example, an H3 that's styled to look like an H2)

• Text that's only accessible via assistive technology - alt text, aria-labels (for example, an "Edit" link with the aria-label "Edit address")

• Focus management between pages or screens

• Reading order

• Tab/focus order (for interactive elements)

• Any elements requiring aria

• Alt text for images/icons

• Legend and fieldset, if you're creating a form

Annotation Kits

Use these kits to make your annotations: VA Annotations Figma library

Consider prototyping in CodePen or Codespaces

You'll eventually test with users of assistive technology (AT). In general, AT works best with coded prototypes. Before research begins, consider creating your prototype in CodePen or Codespaces for the most accurate research results.

Resources for Developers

Following accessibility best practices and VA guidelines results in more accessible products for all Veterans.

Apply accessibility best practices

• Associate a label with every form control

• Include alternative text for images

• Identify page language and language changes

• Use mark-up to convey meaning and structure

• Help users avoid and correct mistakes

• Reflect the reading order in the code order

• Write code that adapts to the user’s technology

• Provide meaning for non-standard interactive elements

• Ensure that all interactive elements are keyboard accessible

Use VA Design System components

Don't re-create the wheel! If you're looking for a specific component, turn to the VA Design System before creating something new.

• Components: Components are interactive and non-interactive UI elements that can be grouped together or presented individually.

• Patterns: Patterns are solutions and researched best practices for solving user-focused tasks and recurring user interface design problems, like multi-part web forms and progressive disclosure.

• Templates: Templates, or page layouts, compose components within a single page. A layout can contain multiple variations of a component depending on the context.

• Foundational elements: These include colors, breakpoints, icons, typography, spacing units, and utility classes.

Test as you develop your product

Review the accessibility section of VA Platform for information about TestRail, end-to-end testing with Cypress, screen reader testing, and more.

Resources for Product Managers

Product managers at VA play a key role in “shifting left” - putting accessibility at the heart of the entire product lifecycle. 

Onboard team members

• Ensure all new team members go through accessibility onboarding.

Organize your sprints and meetings

• Invite accessibility specialists to relevant meetings, from the beginning of the project.

• Prioritize and advocate for accessibility reviews, audits, and testing.

• Help the team meet accessibility requirements as part of the Collaboration Cycle.

Write accessibility-minded tickets

• Work accessibility into team and scrum ceremonies, e.g., add accessibility into acceptance criteria.

• Pull accessibility defects into sprints when necessary (learn about the defect severity rubric and how to write accessibility defect tickets).

Get support for your team

• Reach out to the ADE team for any accessibility-related support.

Get Help from Accessibility Specialists

There are two routes to access support from accessibility specialists:

1. During the Collaboration Cycle, from the Governance team.

2. At any point in your product's lifecycle, from ADE and other accessibility specialists.

Route 1: Collaboration Cycle support from Governance

Teams creating new features or products are required to go through the Collaboration Cycle, which includes accessibility reviews. Teams iterating on existing features or products are encouraged to get feedback through the Cycle as well. The Collaboration Cycle is managed by the Governance team.

Collaboration Cycle

The Collaboration Cycle, managed by the Platform Governance team, is where teams who build products/features on VA.gov get feedback and guidance to ensure they meet VA.gov experience standards for design, content, information architecture, quality assurance, accessibility, and research.

Teams engage with the Collaboration Cycle throughout their product’s/feature’s lifecycle via three separate touchpoint meetings (Design Intent, Midpoint Review and Staging).

Learn how the Collaboration Cycle works, and contact the Governance team with your questions.

Route 2: General accessibility support from ADE

At any point in the product/feature lifecycle, teams can get general accessibility support from the Accessibility Digital Experience (ADE) team. They can also reach out to specialists on Slack.

ADE

The Accessibility Digital Experience (ADE) team is here to support your accessibility needs, no matter how far along you are in the product/feature lifecycle. You can reach out to ADE even if you’re in the Collaboration Cycle process.

How ADE can help

• Evaluate your product at any stage - from wireframe to developed code - and provide feedback and recommendations

• Provide screen reader tech support and accessibility-focused observations during user research sessions with users of assistive technology

• Answer general questions about accessibility best practices

Check out the menu of offerings that ADE provides.

Get started with ADE

• To start working with ADE, submit an ADE ticket.

• Contact the team using their handle: @accessibility-de on the #accessibility-help channel.

Other ways to contact accessibility specialists

• Embedded accessibility specialists: Several product teams have embedded accessibility specialists.

  • If you're on one of those teams, reach out to your specialist for help and advice.

  • If your team does not have a dedicated accessibility specialist, please submit a ticket with ADE for support.

• Slack: VA accessibility specialists are available on Slack in the #accessibility-help channel.

  • No worries if you don't know what exactly you need. Ask your question, and a specialist will help you as soon as possible.

How accessibility specialists provide feedback

Accessibility specialists may engage with you in Slack, leave comments on your Figma mockups, write up their findings, or create formal GitHub issue tickets.

Receiving feedback from the ADE team

The ADE team can adjust to your needs. Depending on the product and team in question, ADE may opt to provide feedback in the team's Slack channel, or as comments in a mockup.

For more detailed, thorough reviews, ADE accessibility specialists will write up their findings and post them as a comment in the related GitHub ticket. They'll share a link to the findings with the team via Slack and any related GitHub issue tickets.

• Product reviews include existing and potential accessibility issues, and proposed solutions. In general, this is what ADE looks for and what tools ADE uses to audit a product.

• User research findings include accessibility issues found during testing, participant quotes, and research synthesis from the ADE team.

Collaboration Cycle Design Intent and Midpoint Review Tickets

The Governance team will provide suggestions for how to develop an accessible product based on your user flows, wireframes, and mockups.

Accessibility specialists will document their feedback on the VFS-provided artifacts following the Must, Should, and Consider Framework. They may also provide additional notes that don’t comment on the artifacts themselves but are important for implementation (eg. engineering/coding notes).

Collaboration Cycle Staging Review Tickets

During a Collaboration Cycle Staging Review, accessibility specialists will review your product. If they find any accessibility issues, they’ll write a ticket for each issue that outlines:

• The issue (often with screenshots or video examples)

• A proposed solution

• The VA experience standard related to the issue

• The defect severity level

Learn more about Staging Review Issue tickets.

Creating Tickets

If you’re reviewing your product for accessibility issues, you can write your own tickets to keep track of your findings and close them upon completion.

Learn how to write good accessibility tickets. To help get you started, here’s a list of common accessibility issues.

Ensure that your work is Section 508 compliant

The VA Section 508 Office validates compliance with federal law mandating accessible information and communication technology.

• Product teams working on authenticated pages and applications are required to submit a VA Section 508 Office Audit Request. We prefer that you submit your request before launch, if possible. But you may still launch before you receive the audit.

• The Section 508 Office can also review your non-HTML documents (PDF, DOCX) for accessibility issues.

  • Learn when and how to create accessible non-HTML documents.

Request support from the VA Section 508 office.

Improve your skills

Accessibility Champs

Accessibility Champions is a grassroots, volunteer-led educational program. Anyone working at the VA, with access to the OCTO Slack channel, can become an accessibility champion through this curriculum!

Start your Accessibility Champs journey.

VA Trauma Community

The VA trauma community is a grassroots, volunteer led multi-disciplinary community focused on maturing our approach to trauma from facilitating research to caring for practitioners. 

Learn more about the Trauma Community.

Accessibility Overview

• 18F’s accessibility guide

• Accessibility roles in government

Technical Considerations

Review the PowerPoint presentations related to buttons, links, focus management, headings, and live regions.

Cognitive issues

• Cognitive considerations

Assistive technology

• Tips for usability testing with people with disabilities.

• Getting started with keyboard navigation and screen readers.

• Testing with assistive technology users.

• Designing for people with Traumatic Brain Injuries.

Page Content Sources

The goal of this page is to provide a well-organized clearinghouse of information about VA's accessibility practices. Our mission - to point VFS teams to the information, tools, and people they need to make VA.gov accessible, beyond compliance. This page is a Work in Progress (WIP).

About the Audit

This page was created as a result of a content audit of accessibility documentation found across multiple environments. It was then analyzed and aggregated to reflect current accessibility practices.

Help and feedback

• Suggest content changes to this page.

• Submit new Platform Website content.

• Get help from the Platform Support Team in Slack.

• Submit a feature idea to the Platform.