{ "doc": { "id": "accessibility/connect-and-extend/download-reports", "title": "Download an Accessibility report", "description": "Export a Cypress run's accessibility violations as a CSV or JSON file for offline analysis, sharing, or handing to an AI agent.", "section": "accessibility", "source_path": "/llm/markdown/accessibility/connect-and-extend/download-reports.md", "version": "8f1d7083a0ee75fbf631bb4680201f11875a483c", "updated_at": "2026-09-01T18:01:49.310Z", "headings": [ { "id": "accessibility/connect-and-extend/download-reports#download-reports", "text": "Download reports", "level": 1 }, { "id": "accessibility/connect-and-extend/download-reports#whats-in-the-file", "text": "What's in the file", "level": 2 }, { "id": "accessibility/connect-and-extend/download-reports#map-the-results-to-your-components", "text": "Map the results to your components", "level": 3 }, { "id": "accessibility/connect-and-extend/download-reports#work-with-the-downloaded-file", "text": "Work with the downloaded file", "level": 2 } ] }, "content": { "type": "root", "children": [ { "type": "heading", "depth": 1, "children": [ { "type": "text", "value": "Download reports" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "The download button at the top of a run's Accessibility report exports the run's violations as a file you can keep, share, or hand to an AI agent for analysis. It sits beside the Documentation link as a download icon; select it to choose either `.csv` or `.json`." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "The export is a portable snapshot of a single run. Unlike the " }, { "type": "link", "title": null, "url": "/llm/markdown/accessibility/connect-and-extend/results-api.md", "children": [ { "type": "text", "value": "Results API" } ] }, { "type": "text", "value": " (built for CI assertions) and " }, { "type": "link", "title": null, "url": "/llm/markdown/cloud/integrations/cloud-mcp.md", "children": [ { "type": "text", "value": "Cypress Cloud MCP" } ] }, { "type": "text", "value": " (built for live querying), a downloaded report needs no Cloud connection to work with after the fact. This makes it a good fit for:" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "offline analysis" } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "custom spreadsheets and charts" } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "sharing with people who don't use Cypress Cloud" } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "comparing multiple runs in detail by downloading a file for each." } ] } ] } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "For other ways to get results out of Cypress Cloud, see the " }, { "type": "link", "title": null, "url": "/llm/markdown/accessibility/connect-and-extend/overview.md", "children": [ { "type": "text", "value": "Connect & extend overview" } ] }, { "type": "text", "value": "." } ] }, { "type": "heading", "depth": 2, "children": [ { "type": "text", "value": "What's in the file" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Each row represents a single failed element for a single rule on a single view. Because an element can fail the same rule on more than one view, that element appears once per view. Both formats contain the same fields:" } ] }, { "type": "table", "align": [ null, null ], "children": [ { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "Column" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "Description" } ] } ] }, { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "Rule ID" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "The Axe Core® or " }, { "type": "link", "title": null, "url": "/llm/markdown/accessibility/core-concepts/cypress-rules.md", "children": [ { "type": "text", "value": "Cypress rule" } ] }, { "type": "text", "value": " identifier." } ] } ] }, { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "Description" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "A summary of what the rule checks." } ] } ] }, { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "Impact" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "The severity level: critical, serious, moderate, or minor." } ] } ] }, { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "Help" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "A short description of how to fix the issue." } ] } ] }, { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "Help URL" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "A link to the rule's documentation." } ] } ] }, { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "Tags" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "The standards and categories associated with the rule, such as `wcag2aa`." } ] } ] }, { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "Element" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "The selector identifying the failing element." } ] } ] }, { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "Element URL" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "A deep link into the Cloud report, filtered to this element." } ] } ] }, { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "Status" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "The element's status: `fail`, `incomplete`, or `ignore` (only `fail` is currently supported)." } ] } ] }, { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "Failure Summaries" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "The specific reasons the element failed, as reported during the run." } ] } ] }, { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "View" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "The name of the page or component where the element was found." } ] } ] }, { "type": "tableRow", "children": [ { "type": "tableCell", "children": [ { "type": "text", "value": "View URL" } ] }, { "type": "tableCell", "children": [ { "type": "text", "value": "A deep link into the Cloud report for this view." } ] } ] } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "The Element URL and View URL columns link back to the live report in Cypress Cloud, so you (or an agent) can always jump from a row to the full DOM snapshot and context." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "The `.json` export wraps the rows in an object with `rows`, `rowCount`, `truncated`, and `columns` fields. The `truncated` flag is `true` only if a run is large enough to exceed the export's row limit; typical runs are well within it. In the `.csv` export, multi-value fields such as Tags and Failure Summaries are JSON-encoded within their cell so they parse back cleanly." } ] }, { "type": "heading", "depth": 3, "children": [ { "type": "text", "value": "Map the results to your components" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "If you configure " }, { "type": "link", "title": null, "url": "/llm/markdown/accessibility/configuration/components.md", "children": [ { "type": "text", "value": "component identification" } ] }, { "type": "text", "value": ", the Element selector in each row reflects a true hierarchy of your components rather than a raw DOM path. This makes patterns easy to spot—such as one component being responsible for a large share of a run's violations—and lets an AI agent trace an issue to its source without re-parsing full-page HTML or crawling your codebase. See " }, { "type": "link", "title": null, "url": "/llm/markdown/accessibility/work-with-ai-agents.md#Map-violations-to-your-components", "children": [ { "type": "text", "value": "Work with AI agents" } ] }, { "type": "text", "value": " for how this pays off." } ] }, { "type": "heading", "depth": 2, "children": [ { "type": "text", "value": "Work with the downloaded file" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "A downloaded report is designed to be handed straight to an AI agent to interpret, chart, or compare against another run. For concrete prompts and workflows, see " }, { "type": "link", "title": null, "url": "/llm/markdown/accessibility/work-with-ai-agents.md#Work-with-a-downloaded-report", "children": [ { "type": "text", "value": "Work with a downloaded report" } ] }, { "type": "text", "value": "." } ] } ] }, "token_estimate": 763 }