{
  "doc": {
    "id": "ui-coverage/troubleshooting",
    "title": "Troubleshooting | Cypress UI Coverage",
    "description": "Common problems and solutions for Cypress UI Coverage.",
    "section": "ui-coverage",
    "source_path": "/llm/markdown/ui-coverage/troubleshooting.md",
    "version": "48b03b5502f7aea1d0454750cce208f775403542",
    "updated_at": "2026-05-20T19:00:20.270Z",
    "headings": [
      {
        "id": "ui-coverage/troubleshooting#troubleshooting",
        "text": "Troubleshooting",
        "level": 1
      },
      {
        "id": "ui-coverage/troubleshooting#a-single-element-appears-as-multiple-elements",
        "text": "A single element appears as multiple elements",
        "level": 2
      },
      {
        "id": "ui-coverage/troubleshooting#solutions",
        "text": "Solutions",
        "level": 3
      },
      {
        "id": "ui-coverage/troubleshooting#multiple-different-elements-are-identified-as-the-same",
        "text": "Multiple different elements are identified as the same",
        "level": 2
      },
      {
        "id": "ui-coverage/troubleshooting#solutions",
        "text": "Solutions",
        "level": 3
      },
      {
        "id": "ui-coverage/troubleshooting#similar-elements-are-not-grouped-together",
        "text": "Similar elements are not grouped together",
        "level": 2
      },
      {
        "id": "ui-coverage/troubleshooting#solutions",
        "text": "Solutions",
        "level": 3
      },
      {
        "id": "ui-coverage/troubleshooting#different-elements-are-incorrectly-grouped-together",
        "text": "Different elements are incorrectly grouped together",
        "level": 2
      },
      {
        "id": "ui-coverage/troubleshooting#solutions",
        "text": "Solutions",
        "level": 3
      }
    ]
  },
  "chunks": [
    {
      "id": "ui-coverage/troubleshooting#a-single-element-appears-as-multiple-elements",
      "doc_id": "ui-coverage/troubleshooting",
      "heading": "A single element appears as multiple elements",
      "heading_level": 2,
      "content_markdown": "## A single element appears as multiple elements\n\nWhen a single element is identified as multiple distinct elements in UI Coverage, it may indicate an issue with [Element Identification](/llm/markdown/ui-coverage/core-concepts/element-identification.md). This often occurs due to:\n\n*   Auto-generated or dynamic attributes (e.g., UUIDs) that differ across snapshots.\n*   Library-specific identifiers, such as id attributes generated by frameworks.\n\n### Solutions\n\n*   **Add Unique Identifiers**: Assign a stable identifier like `data-cy` or `data-test` to the element.\n*   **Ignore Dynamic Attributes**: Use [`attributeFilters`](/llm/markdown/ui-coverage/configuration/attributefilters.md) to exclude attributes that change across tests.\n*   **Manually Configure Identification**: Use [elements](/llm/markdown/ui-coverage/configuration/elements.md) configuration to explicitly define how the element should be identified.\n",
      "section": "ui-coverage",
      "anchors": [
        "a-single-element-appears-as-multiple-elements"
      ],
      "path": "/llm/json/chunked/ui-coverage/troubleshooting.json",
      "token_estimate": 135
    },
    {
      "id": "ui-coverage/troubleshooting#solutions",
      "doc_id": "ui-coverage/troubleshooting",
      "heading": "Solutions",
      "heading_level": 3,
      "content_markdown": "### Solutions\n\n*   **Add Unique Identifiers**: Assign a stable identifier like `data-cy` or `data-test` to the element.\n*   **Ignore Dynamic Attributes**: Use [`attributeFilters`](/llm/markdown/ui-coverage/configuration/attributefilters.md) to exclude attributes that change across tests.\n*   **Manually Configure Identification**: Use [elements](/llm/markdown/ui-coverage/configuration/elements.md) configuration to explicitly define how the element should be identified.\n",
      "section": "ui-coverage",
      "anchors": [
        "solutions"
      ],
      "path": "/llm/json/chunked/ui-coverage/troubleshooting.json",
      "token_estimate": 61
    },
    {
      "id": "ui-coverage/troubleshooting#multiple-different-elements-are-identified-as-the-same",
      "doc_id": "ui-coverage/troubleshooting",
      "heading": "Multiple different elements are identified as the same",
      "heading_level": 2,
      "content_markdown": "## Multiple different elements are identified as the same\n\nIf different elements are being grouped as one in UI Coverage, this could be due to insufficient or non-specific identifiers, such as:\n\n*   Missing unique `data-*` or `id` attributes.\n*   Generic identifiers like `data-test=\"button\"` shared across multiple elements.\n*   Use of attributes not prioritized by UI Coverage, like `aria-label`.\n\n### Solutions\n\n*   **Add unique identifiers**: Assign distinct identifiers like `data-cy` or `data-test` values to each element.\n*   **Filter generic attributes**: Exclude unrepresentative attributes using [`attributeFilters`](/llm/markdown/ui-coverage/configuration/attributefilters.md) configuration.\n*   **Customize attribute use**: Update [`significantAttributes`](/llm/markdown/ui-coverage/configuration/significantattributes.md) configuration to prioritize relevant identifiers.\n*   **Manually Identify Elements**: Use [elements](/llm/markdown/ui-coverage/configuration/elements.md) configuration to specify how elements should be identified.\n",
      "section": "ui-coverage",
      "anchors": [
        "multiple-different-elements-are-identified-as-the-same"
      ],
      "path": "/llm/json/chunked/ui-coverage/troubleshooting.json",
      "token_estimate": 147
    },
    {
      "id": "ui-coverage/troubleshooting#solutions",
      "doc_id": "ui-coverage/troubleshooting",
      "heading": "Solutions",
      "heading_level": 3,
      "content_markdown": "### Solutions\n\n*   **Add unique identifiers**: Assign distinct identifiers like `data-cy` or `data-test` values to each element.\n*   **Filter generic attributes**: Exclude unrepresentative attributes using [`attributeFilters`](/llm/markdown/ui-coverage/configuration/attributefilters.md) configuration.\n*   **Customize attribute use**: Update [`significantAttributes`](/llm/markdown/ui-coverage/configuration/significantattributes.md) configuration to prioritize relevant identifiers.\n*   **Manually Identify Elements**: Use [elements](/llm/markdown/ui-coverage/configuration/elements.md) configuration to specify how elements should be identified.\n",
      "section": "ui-coverage",
      "anchors": [
        "solutions"
      ],
      "path": "/llm/json/chunked/ui-coverage/troubleshooting.json",
      "token_estimate": 69
    },
    {
      "id": "ui-coverage/troubleshooting#similar-elements-are-not-grouped-together",
      "doc_id": "ui-coverage/troubleshooting",
      "heading": "Similar elements are not grouped together",
      "heading_level": 2,
      "content_markdown": "## Similar elements are not grouped together\n\nIf elements performing the same action are not [grouped](/llm/markdown/ui-coverage/core-concepts/element-grouping.md), it may be due to:\n\n*   Library-specific identifiers, like dynamic `id` values, are not representative of the element and prevent grouping.\n*   Identifiers that include dynamic data, such as UUID's\n\n### Solutions\n\n*   **Use Shared Identifiers**: Apply consistent `data-cy` or `data-test` values across similar elements.\n*   **Ignore Dynamic Attributes**: Configure [`attributeFilters`](/llm/markdown/ui-coverage/configuration/attributefilters.md) to exclude varying attributes.\n*   **Manually Group Elements**: Use [`elementGroups`](/llm/markdown/ui-coverage/configuration/elementgroups.md) configuration to define custom groupings.\n",
      "section": "ui-coverage",
      "anchors": [
        "similar-elements-are-not-grouped-together"
      ],
      "path": "/llm/json/chunked/ui-coverage/troubleshooting.json",
      "token_estimate": 109
    },
    {
      "id": "ui-coverage/troubleshooting#solutions",
      "doc_id": "ui-coverage/troubleshooting",
      "heading": "Solutions",
      "heading_level": 3,
      "content_markdown": "### Solutions\n\n*   **Use Shared Identifiers**: Apply consistent `data-cy` or `data-test` values across similar elements.\n*   **Ignore Dynamic Attributes**: Configure [`attributeFilters`](/llm/markdown/ui-coverage/configuration/attributefilters.md) to exclude varying attributes.\n*   **Manually Group Elements**: Use [`elementGroups`](/llm/markdown/ui-coverage/configuration/elementgroups.md) configuration to define custom groupings.\n",
      "section": "ui-coverage",
      "anchors": [
        "solutions"
      ],
      "path": "/llm/json/chunked/ui-coverage/troubleshooting.json",
      "token_estimate": 48
    },
    {
      "id": "ui-coverage/troubleshooting#different-elements-are-incorrectly-grouped-together",
      "doc_id": "ui-coverage/troubleshooting",
      "heading": "Different elements are incorrectly grouped together",
      "heading_level": 2,
      "content_markdown": "## Different elements are incorrectly grouped together\n\nIf unrelated elements are [grouped](/llm/markdown/ui-coverage/core-concepts/element-grouping.md), it may be due to overly generic identifiers or shared attributes. Some common examples of this include:\n\n*   Missing unique attributes that could distinguish the elements.\n*   Generic values like `data-test=\"button\"` shared across different elements.\n\n### Solutions\n\n*   **Add Distinct Identifiers**: Use unique `data-cy` or `data-test` values for each element.\n*   **Filter Shared Attributes**: Exclude generic identifiers with [`attributeFilters`](/llm/markdown/ui-coverage/configuration/attributefilters.md) configuration.\n*   **Update Identification Rules**: Adjust [`significantAttributes`](/llm/markdown/ui-coverage/configuration/significantattributes.md) configuration to improve differentiation.\n*   **Manually Separate Groups**: Define individual groups using [`elementGroups`](/llm/markdown/ui-coverage/configuration/elementgroups.md) configuration.\n",
      "section": "ui-coverage",
      "anchors": [
        "different-elements-are-incorrectly-grouped-together"
      ],
      "path": "/llm/json/chunked/ui-coverage/troubleshooting.json",
      "token_estimate": 123
    },
    {
      "id": "ui-coverage/troubleshooting#solutions",
      "doc_id": "ui-coverage/troubleshooting",
      "heading": "Solutions",
      "heading_level": 3,
      "content_markdown": "### Solutions\n\n*   **Add Distinct Identifiers**: Use unique `data-cy` or `data-test` values for each element.\n*   **Filter Shared Attributes**: Exclude generic identifiers with [`attributeFilters`](/llm/markdown/ui-coverage/configuration/attributefilters.md) configuration.\n*   **Update Identification Rules**: Adjust [`significantAttributes`](/llm/markdown/ui-coverage/configuration/significantattributes.md) configuration to improve differentiation.\n*   **Manually Separate Groups**: Define individual groups using [`elementGroups`](/llm/markdown/ui-coverage/configuration/elementgroups.md) configuration.\n",
      "section": "ui-coverage",
      "anchors": [
        "solutions"
      ],
      "path": "/llm/json/chunked/ui-coverage/troubleshooting.json",
      "token_estimate": 60
    }
  ]
}