Skip to main content

This checklist helps Gainsight customers evaluate their community’s compliance with the European Accessibility Act (EAA) and improve accessibility through technical testing and configuration best practices.

Overview

Gainsight is committed to building inclusive digital experiences across its Customer Communities platform. This Accessibility Testing Checklist helps community admins and managers ensure their configurations comply with the European Accessibility Act (EAA) and WCAG 2.1 & 2.2 AA standards.

While Gainsight maintains an accessible infrastructure, customization, such as styling, widgets, and content, can introduce risks. This checklist outlines key areas to review, including:

  • Color contrast
  • Alt text for images
  • ARIA labels for screen readers
  • Tap or keyboard accessibility
  • Compliance documentation

Gainsight recommends using this guide during implementation, testing, and regular maintenance to meet legal requirements and create a more usable experience for all visitors, including those using assistive technologies.

Check Your Accessibility Score

Before making accessibility improvements, it is helpful to understand your current standing. Gainsight recommends using Google's Lighthouse, a trusted, automated tool that evaluates web accessibility based on WCAG guidelines.

Follow these steps to get your baseline score:

  1. Navigate to https://pagespeed.web.dev
  2. Enter your community domain.
  3. Click Analyze.
  4. Scroll to view the Accessibility score.

Note: While automatic tools identify most of the common issues, additional manual testing is also recommended.

Ensure Sufficient Color Contrast

Gainsight enables customers to control community color settings. While this supports brand customization, it may introduce accessibility risks.

Requirements:

  • Use a minimum contrast ratio of 4.5:1 for body text.
  • Use at least 3:1 for non-text UI elements (for example, buttons).
  • Avoid combinations like yellow text on a white background.

Check font and background contrast for all elements, including:

  • Widgets
  • Cards
  • Buttons

Add Descriptive Alt Text to Images

Alt text ensures that screen readers can describe images to users with visual impairments.

For the following Out-of-the-Box widgets, ensure all images include descriptive alt text:

  • Quick Links
  • Banner
  • Custom Pages
  • Overview Pages

Note: If an image is decorative only (for example, color blocks), leave the alt text field blank.

For Custom Widgets, add alt attributes manually in the HTML of your custom widgets.

Use ARIA Labels for Custom Elements

When customizing your Gainsight Community, especially with custom HTML or CSS, it is essential to ensure that assistive technologies such as screen readers can interpret and navigate your content accurately. ARIA (Accessible Rich Internet Applications) labels make this possible by providing descriptive metadata about elements that may not be inherently accessible.

Use ARIA attributes to describe the role, state, or function of custom buttons, interactive elements, or dynamic content. This helps users relying on screen readers understand how to interact with your community's features.

Avoid Auto-Play, Auto-Scroll, or Tap-Only Triggers

Automated behaviors such as videos that auto-play on load or content that scrolls automatically can create significant barriers for users with visual, cognitive, or motor impairments. These actions can disorient users, interfere with assistive technologies, or prevent keyboard navigation.

To support accessibility and comply with WCAG and EAA guidelines, ensure that:

  • Videos or audio files do not auto-play unless user-initiated or fully controllable (with pause or stop options).
  • Auto-scrolling or auto-advancing elements (for example, carousels, sliders) are disabled or include pause controls.
  • Interactive content (such as buttons, modals, tabs) can be triggered using both keyboard (Enter, Space) and screen readers, not just a mouse or tap.

Additional Tips for Technical Testing

Use these techniques to validate accessibility:

  • Use automated tools like Axe, WAVE, Pa11y.
  • Test keyboard navigation (Tab, Shift+Tab, Enter, Escape).
  • Include participants with varied accessibility requirements during usability testing.
  • Offer a feedback mechanism for users to report accessibility issues.

Maintain Compliance Documentation

Accessibility is not just a best practice; it is a legal requirement in many regions, including under the European Accessibility Act (EAA) and WCAG 2.1 and  2.2 AA guidelines. To demonstrate conformance and support audits, Gainsight recommends maintaining clear, organized documentation of your community’s accessibility practices.

Key Documentation to Maintain:

  • Accessibility Statement: Publish a public-facing statement outlining your commitment to accessibility, known limitations, and how users can request support.
  • Testing Methodology: Document your accessibility testing process, including tools used (for example, Axe, Lighthouse, screen readers), manual procedures, and frequency.
  • VPAT or Conformance Report: Prepare a Voluntary Product Accessibility Template (VPAT) or equivalent conformance documentation that maps your platform’s accessibility against WCAG 2.1 and 2.2 AA standards.

Summary: What to Check

 

Area

Action

Color Contrast

Ensure compliant contrast ratios (4.5:1 for text, 3:1 for UI)

Alt Text

Add alt text to all images or leave empty if decorative

ARIA Attributes

Add where custom elements are used

Auto-Play or Scroll

Provide manual controls to pause, stop, or navigate content

Keyboard Navigation

Validate that all content is usable without a mouse

Feedback Mechanism

Include a way for users to report accessibility issues

Documentation

Maintain testing logs and publish accessibility statements

 

For more information on how to use this checklist or to clarify any of the steps, comment directly on this article.

For broader questions about accessibility configurations or best practices within Gainsight Customer Communities, start a new topic in the Gainsight Community to engage with our team and other users.

Related Resources

Be the first to reply!