The GitHub Annotation Toolkit aims to support disabled designers, engineers, and other collaborators in creating, reading, and discussing annotations. This statement covers the Figma library and its documentation, rather than the accessibility of products that use its annotations.
Figma documents keyboard and screen-reader support for canvas objects. Its accessibility guidance covers navigation, screen-reader settings, canvas zoom, interface scaling, and enhanced interface contrast.
Canvas zoom enlarges annotations, while interface scaling enlarges Figma's controls. Enhanced interface contrast changes Figma's interface, not the library's stamp colors.
Stamps mark design elements. Details components hold accompanying written explanations.
- Text labels and icons distinguish annotation types without relying on color alone.
- The palette pairs stamp labels with contrasting backgrounds. Outlines and shadows help separate stamps from the canvas and the designs they overlap.
- Pin, Bracket, and Lasso formats offer different ways to point to an element or group. Adjustable label positions help keep the underlying design visible.
- Matching note numbers connect Stamps and Details visually. Optional fields let authors adjust the amount of detail without crowding the design.
The Getting started guide explains these options.
Tutorials and checklists provide written guidance outside Figma. They explain how to use annotations and what information to capture; they do not reproduce the content of each annotated design.
Report any issues through the public issue tracker. Include the affected component or documentation page, the task, and a written explanation of what blocks or complicates it.
Screenshots, recordings, and details about Figma, the browser, operating system, or assistive technology are optional. Do not include confidential designs or medical information in public reports.
Stamps and Details rely on canvas position, connecting lines, and matching note numbers to communicate relationships. Access to an individual canvas object is not equivalent to understanding which element an annotation describes or how it relates to other notes.
These are library components, not Figma's native annotations. Accessibility features for native annotations or prototypes do not automatically apply to those relationships.
For collaborators who cannot follow the canvas, provide a structured text description alongside the design. Identify the element, its intended semantics and behavior, and any relevant ordering. Agree on a format that collaborators can use; a walkthrough can supplement that written record.
Complex designs with many annotations are difficult to follow when stamps overlap, obscure content, or sit far from their Details. The best practices for annotating describe ways to reduce clutter by moving labels outside the design, keeping Details in the margins, and separating complex annotations across frames.
Outlines and shadows do not guarantee legibility on every background. Review contrast and readability in context, especially after changing colors, effects, or placement.
The contribution process includes maintainer review and testing of library changes before merge and publication. The project has not conducted keyboard-only or screen-reader testing of this library, and the repository does not run automated accessibility checks.
This statement describes design choices, not measured contrast ratios or a claim of conformance with the Web Content Accessibility Guidelines (WCAG).
Annotations describe intended semantics and interactions; they do not implement them in Figma or production code. Products built from annotated designs need their own accessibility evaluation. Annotation theory explains the role of annotations as a communication tool.
The contribution guide explains how to propose library changes. This project accepts direct Figma library contributions from GitHub staff; other contributors can share suggestions and examples through issues.
For accessibility-related changes, describe the barrier or access need and distinguish observed behavior from assumptions. Documentation improvements can include clearer instructions, descriptive links, and text alternatives for illustrations.
GitHub's Accessibility Design team maintains the toolkit. Support guidance lists the public feedback route and additional channels for GitHub staff.