{
  "doc": {
    "id": "accessibility/configuration/significantattributes",
    "title": "Significant Attributes | Cypress Accessibility",
    "description": "The `significantAttributes` configuration property allows users to specify custom attributes that should be considered \"significant\" for the purpose of identification and grouping.",
    "section": "accessibility",
    "source_path": "/llm/markdown/accessibility/configuration/significantattributes.md",
    "version": "48b03b5502f7aea1d0454750cce208f775403542",
    "updated_at": "2026-05-20T19:00:20.270Z",
    "headings": [
      {
        "id": "accessibility/configuration/significantattributes#significantattributes",
        "text": "significantAttributes",
        "level": 1
      },
      {
        "id": "accessibility/configuration/significantattributes#why-use-significant-attributes",
        "text": "Why use significant attributes?",
        "level": 2
      },
      {
        "id": "accessibility/configuration/significantattributes#scope",
        "text": "Scope",
        "level": 2
      },
      {
        "id": "accessibility/configuration/significantattributes#syntax",
        "text": "Syntax",
        "level": 2
      },
      {
        "id": "accessibility/configuration/significantattributes#examples",
        "text": "Examples",
        "level": 2
      },
      {
        "id": "accessibility/configuration/significantattributes#marking-specific-attributes-as-significant",
        "text": "Marking specific attributes as significant",
        "level": 3
      },
      {
        "id": "accessibility/configuration/significantattributes#config",
        "text": "Config",
        "level": 4
      },
      {
        "id": "accessibility/configuration/significantattributes#html",
        "text": "HTML",
        "level": 4
      },
      {
        "id": "accessibility/configuration/significantattributes#significant-attributes-tracked",
        "text": "Significant attributes tracked",
        "level": 4
      }
    ]
  },
  "chunks": [
    {
      "id": "accessibility/configuration/significantattributes#why-use-significant-attributes",
      "doc_id": "accessibility/configuration/significantattributes",
      "heading": "Why use significant attributes?",
      "heading_level": 2,
      "content_markdown": "## Why use significant attributes?\n\nCypress uses a [default set of attributes](/llm/markdown/accessibility/core-concepts/element-identification.md) (such as common test ID patterns), in a priority order, as the preferred way to identify elements in reports.\n\nThe values of these attributes are used as element identifiers, which helps us recognize the same element in multiple contexts and deduplicate the findings. This helps when reviewing run reports, or comparing reports in Branch Review.\n\nYou may have attributes already in place in your application that would help with element organization, such as `data-component-name`. If you would like Cypress to use and prioritize these attributes, or you want to change the default priority order, you can define your own list of significant attributes.\n",
      "section": "accessibility",
      "anchors": [
        "why-use-significant-attributes"
      ],
      "path": "/llm/json/chunked/accessibility/configuration/significantattributes.json",
      "token_estimate": 153
    },
    {
      "id": "accessibility/configuration/significantattributes#scope",
      "doc_id": "accessibility/configuration/significantattributes",
      "heading": "Scope",
      "heading_level": 2,
      "content_markdown": "## Scope\n\n**Note:** setting `significantAttributes` impacts both Cypress Accessibility and UI Coverage reports if set at the root of the configuration. Nesting this property under an `accessibility` or `uiCoverage` key is supported, if you need to split them up.\n",
      "section": "accessibility",
      "anchors": [
        "scope"
      ],
      "path": "/llm/json/chunked/accessibility/configuration/significantattributes.json",
      "token_estimate": 52
    },
    {
      "id": "accessibility/configuration/significantattributes#examples",
      "doc_id": "accessibility/configuration/significantattributes",
      "heading": "Examples",
      "heading_level": 2,
      "content_markdown": "## Examples\n\n### Marking specific attributes as significant\n\n#### Config\n\n```\n{  \"significantAttributes\": [\"class\", \"id\", \"data-context\"]}\n```\n\n#### HTML\n\n```\n<body>  <button class=\"primary\" id=\"submit\" data-testid=\"submit\" data-context=\"user-signup\">    Submit  </button></body>\n```\n\n#### Significant attributes tracked\n\n```\nclass=\"primary\", id=\"submit\", data-context=\"user-signup\"\n```\n",
      "section": "accessibility",
      "anchors": [
        "examples"
      ],
      "path": "/llm/json/chunked/accessibility/configuration/significantattributes.json",
      "token_estimate": 51
    },
    {
      "id": "accessibility/configuration/significantattributes#marking-specific-attributes-as-significant",
      "doc_id": "accessibility/configuration/significantattributes",
      "heading": "Marking specific attributes as significant",
      "heading_level": 3,
      "content_markdown": "### Marking specific attributes as significant\n\n#### Config\n\n```\n{  \"significantAttributes\": [\"class\", \"id\", \"data-context\"]}\n```\n\n#### HTML\n\n```\n<body>  <button class=\"primary\" id=\"submit\" data-testid=\"submit\" data-context=\"user-signup\">    Submit  </button></body>\n```\n\n#### Significant attributes tracked\n\n```\nclass=\"primary\", id=\"submit\", data-context=\"user-signup\"\n```\n",
      "section": "accessibility",
      "anchors": [
        "marking-specific-attributes-as-significant"
      ],
      "path": "/llm/json/chunked/accessibility/configuration/significantattributes.json",
      "token_estimate": 48
    }
  ]
}