Skip to content

feat: Updated VPAT 2026#4

Open
daisymarie128 wants to merge 3 commits intomasterfrom
daisy/epd-731
Open

feat: Updated VPAT 2026#4
daisymarie128 wants to merge 3 commits intomasterfrom
daisy/epd-731

Conversation

@daisymarie128
Copy link
Copy Markdown

@daisymarie128 daisymarie128 commented Apr 19, 2026

Summary

Replaces the 2020 web VPAT with a fully refreshed April 2026 edition reflecting Buffer's current accessibility posture across Publish, Analyze, and Start Page.

What changed

  • Upgraded VPAT version: VPAT 2.1 → VPAT 2.5 International Edition
  • Expanded standards coverage: now reports against WCAG 2.1 AA, WCAG 2.2 AA, Revised Section 508, and EN 301 549 V3.2.1 (previously only WCAG 2.0)
  • Added new sections: full Section 508 report (Chapters 3/5/6) and full EN 301 549 report (Clauses 4–13)
  • Refreshed remarks across all criteria based on manual testing (macOS VoiceOver + Safari), Axe scans, Stark design audits, and engineering code review
  • Terminology update: conformance levels now use VPAT 2.5 wording ("Partially Supports" in place of "Supports with Exceptions")

Why

The previous VPAT was five years old and referenced a superseded WCAG version. This replacement brings Buffer's public accessibility statement up to current reporting standards and reflects improvements shipped since 2020 (e.g., route-aware page titles, accessible name fixes in channel-connection flows) as well as gaps that remain (e.g., legacy areas in Analyze and Start Page).

Summary by CodeRabbit

  • Documentation
    • Updated accessibility report to VPAT® 2.5 — International Edition (April 2026) with public contact email and standardized footer/disclaimer.
    • Revised product scope to cover Buffer web suite (Publish, Analyze, Start Page).
    • Reorganized WCAG 2.x reporting and conformance terminology (use of “Partially Supports”, revised “Not Evaluated” language), updated criterion conformance and remarks.
    • Added Level AAA clarification, expanded Section 508 chapter-based report, and EN 301 549 clause mappings; noted PDF export and alt-text gaps.

@daisymarie128 daisymarie128 requested review from dace and magarcia April 19, 2026 23:56
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Apr 19, 2026

Walkthrough

The buffer-web.md VPAT was updated from VPAT® Version 2.1 (August 2020) to VPAT® Version 2.5 — International Edition (April 2026). Changes add a public contact email and expand product scope to cover Publish, Analyze, and Start Page. The WCAG section was restructured into a WCAG 2.x report with revised conformance terminology (removing “Supports with Exceptions” in favor of “Partially Supports”), updated criterion links and ratings, and a new Table 3 clarifying Level AAA exclusion. New Revised Section 508 and EN 301 549 reports were added, plus PDF/alt-text notes, a legal disclaimer, and updated footer/report-preparation language.

🚥 Pre-merge checks | ✅ 3 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title 'feat: Updated VPAT 2026' is vague and lacks specificity. While it references the document being updated, it does not convey the primary nature of the change—a comprehensive upgrade from VPAT 2.1 to VPAT 2.5 International Edition with expanded standards coverage. Consider a more descriptive title such as 'feat: Upgrade VPAT to 2.5 International Edition with WCAG 2.2 and EN 301 549 support' to better reflect the scope and significance of the update.
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@buffer-web.md`:
- Around line 459-460: The table links currently point to "#document-top"
instead of the actual WCAG section; update each anchor href that wraps the "WCAG
2.x" text to target the exact heading id of the WCAG 2.x section (replace
href="#document-top" with the real id, e.g., "#wcag-2-x" or whatever id the WCAG
heading generates) for the occurrences around the "WCAG 2.x" link (including the
rows shown and the other occurrences noted: 464-465, 528-529, 725-726, 730-731,
750-751, 789-790, 804-805) so the links navigate directly to the WCAG heading.
- Line 13: Update the product scope sentence that currently reads "This report
covers accessibility conformance for the Buffer web application, which includes
the product suite Publish, Analyze, and Start Page." to include Engage so it
matches the PR objective (Publish, Analyze, Engage, and Start Page); locate and
edit the exact Notes line (the HTML-bold "Notes:" sentence) in buffer-web.md and
make the product list consistent across the document/report.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: efeedde7-9d90-48f7-8705-4f6e86ae8e6c

📥 Commits

Reviewing files that changed from the base of the PR and between c0905da and 328499f.

📒 Files selected for processing (1)
  • buffer-web.md

Comment thread buffer-web.md
<b>Contact Information:</b> <a href="mailto:accessibility@buffer.com">accessibility@buffer.com</a>

<b>Contact Information:</b> <a href = "mailto: accessibility@buffer.com">accessibility@buffer.com</a>
<b>Notes:</b> This report covers accessibility conformance for the Buffer web application, which includes the product suite Publish, Analyze, and Start Page.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Product scope appears incomplete for this VPAT update.

Line 13 excludes Engage, while the PR objective states this report covers Publish, Analyze, Engage, and Start Page. In a conformance report, this scope mismatch can create compliance ambiguity.

Suggested fix
-<b>Notes:</b> This report covers accessibility conformance for the Buffer web application, which includes the product suite Publish, Analyze, and Start Page.
+<b>Notes:</b> This report covers accessibility conformance for the Buffer web application, which includes the product suite Publish, Analyze, Engage, and Start Page.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
<b>Notes:</b> This report covers accessibility conformance for the Buffer web application, which includes the product suite Publish, Analyze, and Start Page.
<b>Notes:</b> This report covers accessibility conformance for the Buffer web application, which includes the product suite Publish, Analyze, Engage, and Start Page.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@buffer-web.md` at line 13, Update the product scope sentence that currently
reads "This report covers accessibility conformance for the Buffer web
application, which includes the product suite Publish, Analyze, and Start Page."
to include Engage so it matches the PR objective (Publish, Analyze, Engage, and
Start Page); locate and edit the exact Notes line (the HTML-bold "Notes:"
sentence) in buffer-web.md and make the product list consistent across the
document/report.

Comment thread buffer-web.md Outdated
Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (1)
buffer-web.md (1)

377-377: Clarify conformance scope wording to match included Level A table.

Line 377 says the report is against “Level AA,” but this VPAT also includes Level A criteria (Table 1). Consider clarifying this sentence to avoid audit-reader confusion (e.g., “reports against WCAG 2.2 Levels A and AA”).

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@buffer-web.md` at line 377, Update the conformance-scope sentence that
currently reads “reports against WCAG 2.2 Level AA” to explicitly include Level
A (e.g., change the phrase "WCAG 2.2 Level AA" to "WCAG 2.2 Levels A and AA" or
"WCAG 2.2 Level A and AA") so the statement matches the included Table 1; locate
the exact sentence containing "Level AA" in buffer-web.md and revise it to
mention both Levels A and AA.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@buffer-web.md`:
- Line 377: Update the conformance-scope sentence that currently reads “reports
against WCAG 2.2 Level AA” to explicitly include Level A (e.g., change the
phrase "WCAG 2.2 Level AA" to "WCAG 2.2 Levels A and AA" or "WCAG 2.2 Level A
and AA") so the statement matches the included Table 1; locate the exact
sentence containing "Level AA" in buffer-web.md and revise it to mention both
Levels A and AA.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 26dd469b-9916-485d-8c12-7b73a67b4a97

📥 Commits

Reviewing files that changed from the base of the PR and between 328499f and 4c2044f.

📒 Files selected for processing (1)
  • buffer-web.md

Copy link
Copy Markdown

@magarcia magarcia left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Left some minor comments, but LGTM

Comment thread buffer-web.md Outdated
## Table 2: Success Criteria, Level AA
### Table 3: Success Criteria, Level AAA

This report does not include Level AAA criteria. Buffer is reporting against WCAG 2.2 Level AA, including WCAG 2.1 Level AA criteria.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wording says "reports against WCAG 2.2 Level AA" but Table 1 below covers Level A criteria as well. Suggest "WCAG 2.2 Levels A and AA" to avoid customer/auditor confusion.

Comment thread buffer-web.md
<b>Platform:</b> Web

<b>Date:</b> August 2020
<b>Date:</b> April 2026
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Consider adding a brief "Last Audited" date distinct from the report date, especially if re-audit cadence is important for compliance procurement. Alternatively, clarify whether the April 2026 date represents audit completion or publication.

This is a good Claude suggestion, could be interesting to keep track of historical audits publicly so it shows is not a dormant document.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for raising this @magarcia . This is something on my task list, to define some follow-up/improvements/future flows for VPAT + Accessibility moving forward.

One goal moving forward will be to have a plan in place, where we can automate a lot of this flow to ensure this document is updated + reviewed at a minimum anually.
But also with some automated scans ~quarterly/half-yearly to ensure maintenance is kept up with and the yearly update is a minimal task 🤔

Comment thread buffer-web.md
<b>Contact Information:</b> <a href="mailto:accessibility@buffer.com">accessibility@buffer.com</a>

<b>Contact Information:</b> <a href = "mailto: accessibility@buffer.com">accessibility@buffer.com</a>
<b>Notes:</b> This report covers accessibility conformance for the Buffer web application, which includes the product suite Publish, Analyze, and Start Page.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Engage is deprecated, so you can safely ignore the comment above, but just wanted to point our Community and whether we want to mention that here.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for mentioning that @dace ! I was torn in some areas what wording to use. For this section in particular I opted to word it as the 3 seperate product "Publish, Analyze, and Start Page" as they all have there own domains. Which led me to leave out sub areas of publish – Community, Insight, Create, Feeds etc as the list felt quite long and cumbersome.

Happy to update if you feel strongly they should be mentioned here though!

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
buffer-web.md (1)

377-377: Consider simplifying the Level AAA exclusion statement.

The phrase "including WCAG 2.1 Level AA criteria" may cause confusion, as WCAG 2.2 Level AA inherently includes all WCAG 2.1 Level AA criteria (the standard is cumulative). The current wording might suggest they are being evaluated separately.

♻️ Clearer alternative wording
-This report does not include Level AAA criteria. Buffer is reporting against WCAG 2.2 Levels A and AA, including WCAG 2.1 Level AA criteria.
+This report does not include Level AAA criteria. Buffer is reporting against WCAG 2.2 Levels A and AA.

Alternatively, if you want to emphasize the version coverage:

-This report does not include Level AAA criteria. Buffer is reporting against WCAG 2.2 Levels A and AA, including WCAG 2.1 Level AA criteria.
+This report does not include Level AAA criteria. Buffer is reporting against WCAG 2.2 Levels A and AA (which incorporates all WCAG 2.1 criteria).
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@buffer-web.md` at line 377, Replace the sentence "This report does not
include Level AAA criteria. Buffer is reporting against WCAG 2.2 Levels A and
AA, including WCAG 2.1 Level AA criteria." in buffer-web.md by removing the
redundant "including WCAG 2.1 Level AA criteria" clause; update it to a simpler
clear form such as "This report does not include Level AAA criteria. Buffer is
reporting against WCAG 2.2 Levels A and AA." to avoid implying separate
evaluation of WCAG 2.1 and WCAG 2.2.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@buffer-web.md`:
- Line 55: Update the list item text for "Not Evaluated" to clarify scope:
change the sentence that currently reads "This can only be used in WCAG Level
AAA criteria" so it instead explains that "Not Evaluated" may be applied to any
criterion the organization chooses not to assess and that the restriction to
WCAG Level AAA is specific to this report's scope; locate the list element
containing the phrase "Not Evaluated" in buffer-web.md and replace the wording
accordingly to make the scope limitation explicit.

---

Nitpick comments:
In `@buffer-web.md`:
- Line 377: Replace the sentence "This report does not include Level AAA
criteria. Buffer is reporting against WCAG 2.2 Levels A and AA, including WCAG
2.1 Level AA criteria." in buffer-web.md by removing the redundant "including
WCAG 2.1 Level AA criteria" clause; update it to a simpler clear form such as
"This report does not include Level AAA criteria. Buffer is reporting against
WCAG 2.2 Levels A and AA." to avoid implying separate evaluation of WCAG 2.1 and
WCAG 2.2.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7c82dd8d-2292-44e8-9301-38cbb8b29e10

📥 Commits

Reviewing files that changed from the base of the PR and between 4c2044f and a02889b.

📒 Files selected for processing (1)
  • buffer-web.md

Comment thread buffer-web.md
<li><b>Partially Supports:</b> Some functionality of the product does not meet the criterion.</li>
<li><b>Does Not Support:</b> The majority of product functionality does not meet the criterion.</li>
<li><b>Not Applicable:</b> The criterion is not relevant to the product.</li>
<li><b>Not Evaluated:</b> The product has not been evaluated against the criterion. This can only be used in WCAG Level AAA criteria.</li>
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Clarify scope limitation for "Not Evaluated" term.

The current wording states "This can only be used in WCAG Level AAA criteria," which reads as a universal VPAT rule. In fact, "Not Evaluated" can apply to any criterion the organization chooses not to assess. The restriction to Level AAA is specific to this report's scope.

📝 Suggested clarification
-  <li><b>Not Evaluated:</b> The product has not been evaluated against the criterion. This can only be used in WCAG Level AAA criteria.</li>
+  <li><b>Not Evaluated:</b> The product has not been evaluated against the criterion. In this report, this is used only for WCAG Level AAA criteria.</li>
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
<li><b>Not Evaluated:</b> The product has not been evaluated against the criterion. This can only be used in WCAG Level AAA criteria.</li>
<li><b>Not Evaluated:</b> The product has not been evaluated against the criterion. In this report, this is used only for WCAG Level AAA criteria.</li>
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@buffer-web.md` at line 55, Update the list item text for "Not Evaluated" to
clarify scope: change the sentence that currently reads "This can only be used
in WCAG Level AAA criteria" so it instead explains that "Not Evaluated" may be
applied to any criterion the organization chooses not to assess and that the
restriction to WCAG Level AAA is specific to this report's scope; locate the
list element containing the phrase "Not Evaluated" in buffer-web.md and replace
the wording accordingly to make the scope limitation explicit.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants