{
  "doc": {
    "id": "cloud/features/smart-orchestration/spec-prioritization",
    "title": "Run failed specs first with spec prioritization in Cypress Cloud",
    "description": "Run previously failed specs first with Cypress Cloud Spec Prioritization to surface failures sooner, debug faster, and cut CI costs.",
    "section": "cloud",
    "source_path": "/llm/markdown/cloud/features/smart-orchestration/spec-prioritization.md",
    "version": "fbc9225067c51c52ee13224e3b702cf8a025ec12",
    "updated_at": "2026-08-14T12:36:26.878Z",
    "headings": [
      {
        "id": "cloud/features/smart-orchestration/spec-prioritization#spec-prioritization",
        "text": "Spec Prioritization",
        "level": 1
      },
      {
        "id": "cloud/features/smart-orchestration/spec-prioritization#what-is-spec-prioritization",
        "text": "What is Spec Prioritization?",
        "level": 2
      },
      {
        "id": "cloud/features/smart-orchestration/spec-prioritization#why-does-spec-prioritization-matter",
        "text": "Why does Spec Prioritization matter?",
        "level": 2
      },
      {
        "id": "cloud/features/smart-orchestration/spec-prioritization#enable-spec-prioritization",
        "text": "Enable Spec Prioritization",
        "level": 2
      },
      {
        "id": "cloud/features/smart-orchestration/spec-prioritization#how-do-i-know-spec-prioritization-took-effect",
        "text": "How do I know Spec Prioritization took effect?",
        "level": 2
      },
      {
        "id": "cloud/features/smart-orchestration/spec-prioritization#run-properties-tab",
        "text": "Run Properties tab",
        "level": 3
      },
      {
        "id": "cloud/features/smart-orchestration/spec-prioritization#specs-tab",
        "text": "Specs tab",
        "level": 3
      },
      {
        "id": "cloud/features/smart-orchestration/spec-prioritization#see-also",
        "text": "See also",
        "level": 2
      }
    ]
  },
  "chunks": [
    {
      "id": "cloud/features/smart-orchestration/spec-prioritization#what-is-spec-prioritization",
      "doc_id": "cloud/features/smart-orchestration/spec-prioritization",
      "heading": "What is Spec Prioritization?",
      "heading_level": 2,
      "content_markdown": "## What is Spec Prioritization?\n\n**Spec Prioritization automatically runs the specs that failed in your previous Cypress run first.** Instead of waiting for the same failures to resurface late in a run, Cypress Cloud surfaces them right away, so you find out whether your latest change worked in minutes instead of waiting for the entire suite to finish.\n\nThe longer it takes to learn that a test is still broken, the slower your whole team moves. Every minute spent waiting on CI is a minute not spent shipping. Spec Prioritization shrinks that wait by putting the specs most likely to fail, the ones that _just_ failed, at the front of the line.\n\n**Benefits:** Running previously failed specs first will:\n\n1.  **Surface failures sooner.** Get the verdict on your fix in the first few minutes of a run instead of the last.\n2.  **Accelerate debugging.** Tighten the edit → run → verify loop so fixes and iterations progress faster.\n3.  **Reduce CI costs.** Paired with [Auto Cancellation](/llm/markdown/cloud/features/smart-orchestration/run-cancellation.md), runs stop as soon as the prioritized failures reappear, cutting wasted compute and lowering your bill.\n",
      "section": "cloud",
      "anchors": [
        "what-is-spec-prioritization"
      ],
      "path": "/llm/json/chunked/cloud/features/smart-orchestration/spec-prioritization.json",
      "token_estimate": 243
    },
    {
      "id": "cloud/features/smart-orchestration/spec-prioritization#why-does-spec-prioritization-matter",
      "doc_id": "cloud/features/smart-orchestration/spec-prioritization",
      "heading": "Why does Spec Prioritization matter?",
      "heading_level": 2,
      "content_markdown": "## Why does Spec Prioritization matter?\n\nConsider a test suite of several spec files that takes **30 minutes** to run, where a failure first occurs **20 minutes** in. Without Spec Prioritization, every attempt to fix that failure means kicking off CI and waiting **20 minutes** all over again just to see whether the change worked, repeating that cycle until it's resolved.\n\nWith Spec Prioritization, the spec that failed runs **first**. That 20-minute wait collapses to a few minutes, and you get an answer almost immediately. Across a suite with multiple spec files and multiple debugging iterations, **this time savings compounds with every run**.\n\nSpec Prioritization only moves previously failed specs to the front of the run. The remaining specs still run in their usual [load-balanced](/llm/markdown/cloud/features/smart-orchestration/load-balancing.md) order and across all your [parallelized](/llm/markdown/cloud/features/smart-orchestration/parallelization.md) machines, so you keep every other Smart Orchestration benefit while getting failures sooner.\n\n**CI Tip: Maximize Your Savings**\n\nOn its own, Spec Prioritization changes the _order_ specs run in, surfacing failures earlier so you can react sooner. To turn that earlier feedback into shorter runs and lower CI bills, pair it with [Auto Cancellation](/llm/markdown/cloud/features/smart-orchestration/run-cancellation.md). When the prioritized failures reappear at the start of a run, Auto Cancellation stops the run right away, avoiding wasted compute on specs you already know will need another pass.\n",
      "section": "cloud",
      "anchors": [
        "why-does-spec-prioritization-matter"
      ],
      "path": "/llm/json/chunked/cloud/features/smart-orchestration/spec-prioritization.json",
      "token_estimate": 287
    },
    {
      "id": "cloud/features/smart-orchestration/spec-prioritization#enable-spec-prioritization",
      "doc_id": "cloud/features/smart-orchestration/spec-prioritization",
      "heading": "Enable Spec Prioritization",
      "heading_level": 2,
      "content_markdown": "## Enable Spec Prioritization\n\n**Spec Prioritization** is a _Smart Orchestration_ feature available to users with a [Business or Enterprise tier Cypress Cloud plan](https://cypress.io/pricing).\n\nWondering if upgrading your Team tier subscription is worth it? Check out the [recommendations](/llm/markdown/cloud/features/recorded-runs.md#Recommendations) on the run overview page to see how much time we predict these features would save you.\n\n**To enable or disable Spec Prioritization at the Project level** (must be an admin user):\n\n1.  Select the desired project within **Projects** in Cypress Cloud.\n2.  Click **Project Settings**.\n3.  Scroll to the **Smart Orchestration** section within Project Settings.\n4.  Toggle **Spec Prioritization** to enable or disable it.\n",
      "section": "cloud",
      "anchors": [
        "enable-spec-prioritization"
      ],
      "path": "/llm/json/chunked/cloud/features/smart-orchestration/spec-prioritization.json",
      "token_estimate": 136
    },
    {
      "id": "cloud/features/smart-orchestration/spec-prioritization#how-do-i-know-spec-prioritization-took-effect",
      "doc_id": "cloud/features/smart-orchestration/spec-prioritization",
      "heading": "How do I know Spec Prioritization took effect?",
      "heading_level": 2,
      "content_markdown": "## How do I know Spec Prioritization took effect?\n\n### Run Properties tab\n\nThe quickest way to check is the **Properties** tab of a run. Its Smart Orchestration section lists each feature with its status for that run, so a **Spec Prioritization** value of **Applied** confirms Cypress Cloud reordered the specs.\n\nYou can also trace _which_ run drove the order: when Spec Prioritization fires, the run displays a **\"Prioritized failed specs from run #X\"** label, where **#X** links back to the source run whose failures were moved to the front of the line. Following that link shows exactly which previous failures Cypress Cloud was reacting to.\n\nIf the status reads anything other than **Applied**, double-check that Spec Prioritization is toggled on in your [project settings](#Enable-Spec-Prioritization) and that the previous run actually recorded test failures for Cypress Cloud to prioritize (as opposed to timeouts or other non-test failures).\n\n### Specs tab\n\nTo see prioritization at the individual spec level, open the [Specs tab](/llm/markdown/cloud/features/recorded-runs.md#Specs-tab). Sorting by **Timeline** might help you find the spec that was moved up. Each spec that was moved up is marked with the Smart Orchestration icon, and hovering it shows a **\"Prioritized by failed specs\"** tooltip.\n",
      "section": "cloud",
      "anchors": [
        "how-do-i-know-spec-prioritization-took-effect"
      ],
      "path": "/llm/json/chunked/cloud/features/smart-orchestration/spec-prioritization.json",
      "token_estimate": 264
    },
    {
      "id": "cloud/features/smart-orchestration/spec-prioritization#run-properties-tab",
      "doc_id": "cloud/features/smart-orchestration/spec-prioritization",
      "heading": "Run Properties tab",
      "heading_level": 3,
      "content_markdown": "### Run Properties tab\n\nThe quickest way to check is the **Properties** tab of a run. Its Smart Orchestration section lists each feature with its status for that run, so a **Spec Prioritization** value of **Applied** confirms Cypress Cloud reordered the specs.\n\nYou can also trace _which_ run drove the order: when Spec Prioritization fires, the run displays a **\"Prioritized failed specs from run #X\"** label, where **#X** links back to the source run whose failures were moved to the front of the line. Following that link shows exactly which previous failures Cypress Cloud was reacting to.\n\nIf the status reads anything other than **Applied**, double-check that Spec Prioritization is toggled on in your [project settings](#Enable-Spec-Prioritization) and that the previous run actually recorded test failures for Cypress Cloud to prioritize (as opposed to timeouts or other non-test failures).\n",
      "section": "cloud",
      "anchors": [
        "run-properties-tab"
      ],
      "path": "/llm/json/chunked/cloud/features/smart-orchestration/spec-prioritization.json",
      "token_estimate": 184
    },
    {
      "id": "cloud/features/smart-orchestration/spec-prioritization#specs-tab",
      "doc_id": "cloud/features/smart-orchestration/spec-prioritization",
      "heading": "Specs tab",
      "heading_level": 3,
      "content_markdown": "### Specs tab\n\nTo see prioritization at the individual spec level, open the [Specs tab](/llm/markdown/cloud/features/recorded-runs.md#Specs-tab). Sorting by **Timeline** might help you find the spec that was moved up. Each spec that was moved up is marked with the Smart Orchestration icon, and hovering it shows a **\"Prioritized by failed specs\"** tooltip.\n",
      "section": "cloud",
      "anchors": [
        "specs-tab"
      ],
      "path": "/llm/json/chunked/cloud/features/smart-orchestration/spec-prioritization.json",
      "token_estimate": 68
    },
    {
      "id": "cloud/features/smart-orchestration/spec-prioritization#see-also",
      "doc_id": "cloud/features/smart-orchestration/spec-prioritization",
      "heading": "See also",
      "heading_level": 2,
      "content_markdown": "## See also\n\n*   [Auto Cancellation](/llm/markdown/cloud/features/smart-orchestration/run-cancellation.md) - pair with Spec Prioritization to stop broken runs early and cut CI costs\n*   [Smart Orchestration Overview](/llm/markdown/cloud/features/smart-orchestration/overview.md) - all the ways Cypress Cloud speeds up and optimizes your CI runs\n*   [Parallelization](/llm/markdown/cloud/features/smart-orchestration/parallelization.md) - run spec files simultaneously across multiple CI machines\n*   [Load Balancing](/llm/markdown/cloud/features/smart-orchestration/load-balancing.md) - distribute specs across machines to minimize overall run duration\n*   [Spec Prioritization FAQ](/llm/markdown/cloud/faq.md#Spec-Prioritization)\n",
      "section": "cloud",
      "anchors": [
        "see-also"
      ],
      "path": "/llm/json/chunked/cloud/features/smart-orchestration/spec-prioritization.json",
      "token_estimate": 87
    }
  ]
}