diff --git a/docs/api/cypress-api/stop.mdx b/docs/api/cypress-api/stop.mdx
new file mode 100644
index 0000000000..bb926fe45a
--- /dev/null
+++ b/docs/api/cypress-api/stop.mdx
@@ -0,0 +1,82 @@
+---
+title: 'Cypress.stop() | Cypress Documentation'
+description: Stop Cypress on failure or any other conditions
+sidebar_label: stop
+---
+
+
+
+# Cypress.stop
+
+Stop the Cypress App on the current machine while tests are running. This can be useful for stopping test execution upon failures or other predefined conditions.
+
+:::tip
+
+**Auto Cancellation**: If you're looking to automatically stop _all tests_ across _multiple machines_ when a test fails, consider using the [Auto Cancellation feature](/cloud/features/smart-orchestration/run-cancellation) in Cypress Cloud.
+
+
+
+:::
+
+## Syntax
+
+```javascript
+Cypress.stop()
+```
+
+## Examples
+
+### Stop tests when a test fails
+
+To ensure tests stop immediately after a failure across any spec file, add the following snippet to your `support/index.js` file:
+
+```javascript
+afterEach(function () {
+ if (this.currentTest.state === 'failed') {
+ Cypress.stop()
+ }
+})
+```
+
+### Abort tests when a condition is met
+
+```javascript
+beforeEach(() => {
+ if (env !== 'expected-condition') {
+ cy.log('Stop tests - environment is not setup correctly')
+ Cypress.stop()
+ }
+})
+```
+
+## Notes
+
+### `cypress run` vs `cypress open` behavior
+
+Calling `Cypress.stop()` during `cypress run` will skip any remaining tests in the current specfile. If recording to Cypress Cloud, all screenshots, videos, and [Test Replay](/cloud/features/test-replay) will still successfully upload.
+
+
+
+Calling `Cypress.stop()` during `cypress open` will stop execution of the Cypress App, but remain open for inspection. The remaining tests will not run.
+
+
+
+### Why choose Auto Cancellation?
+
+[Auto Cancellation](/cloud/features/smart-orchestration/run-cancellation) is available with Cypress Cloud's Business+ plan. It offers several advantages over `Cypress.stop` for stopping tests on **failure**:
+
+1. **Scope of Cancellation:** `Cypress.stop` halts only the current spec file, skipping remaining tests within it. Auto Cancellation, however, stops all tests across all machines and marks the entire run as **cancelled** in Cypress Cloud for better visibility.
+2. **Configurable Thresholds:** Auto Cancellation allows you to define failure thresholds. `Cypress.stop` executes immediately when the specified condition is met.
+3. **Simplified Configuration**: Auto Cancellation settings can be managed in Cypress Cloud, whereas `Cypress.stop` requires manual code changes.
+4. **Optimization with Spec Prioritization**: Combined with [Spec Prioritization](/cloud/features/smart-orchestration/spec-prioritization) (another Business+ feature), Auto Cancellation helps efficiently allocate resources by running previously failing specs first in a new run.
+
+
+
+## See also
+
+- [Auto Cancellation](/cloud/features/smart-orchestration/run-cancellation)
+- [`Cypress.currentTest`](/api/cypress-api/currenttest)
+- [`Cypress.currentRetry`](/api/cypress-api/currentretry)
+- [Load Balancing](/cloud/features/smart-orchestration/load-balancing)
+- [Parallelization](/cloud/features/smart-orchestration/parallelization)
+- [Spec Prioritization](/cloud/features/smart-orchestration/spec-prioritization)
diff --git a/docs/app/references/changelog.mdx b/docs/app/references/changelog.mdx
index 8f9982f377..5e71897053 100644
--- a/docs/app/references/changelog.mdx
+++ b/docs/app/references/changelog.mdx
@@ -8,6 +8,25 @@ sidebar_label: Changelog
# Changelog
+## 14.2.0
+
+_Released 3/12/2025_
+
+**Features:**
+
+- [`Cypress.stop()`](https://on.cypress.io/cypress-stop) is now available to stop the Cypress App on the current machine while tests are running. This can be useful for stopping test execution upon failures or other predefined conditions. Addresses [#518](https://github.com/cypress-io/cypress/issues/518). Addressed in [#31225](https://github.com/cypress-io/cypress/pull/31225).
+
+**Misc:**
+
+- The browser dropdown now has a more minimal design - showing only the icon of the browser selected to the left of the URL. The currently selected browser also now shows at the top of the browser dropdown. Browsers with longer names will now have their names correctly left aligned in the browser dropdown. Addresses [#21755](https://github.com/cypress-io/cypress/issues/21755) and [#30998](https://github.com/cypress-io/cypress/issues/30998). Addressed in [#31216](https://github.com/cypress-io/cypress/pull/31216).
+- Additional CLI options will be displayed in the terminal for some Cloud error messages. Addressed in [#31211](https://github.com/cypress-io/cypress/pull/31211).
+- Updated Cypress Studio with url routing to support maintaining state when reloading. Addresses [#31000](https://github.com/cypress-io/cypress/issues/31000) and [#30996](https://github.com/cypress-io/cypress/issues/30996).
+
+**Dependency Updates:**
+
+- Upgraded `cli-table3` from `0.5.1` to `0.6.5`. Addressed in [#31166](https://github.com/cypress-io/cypress/pull/31166).
+- Upgraded `simple-git` from `3.25.0` to `3.27.0`. Addressed in [#31198](https://github.com/cypress-io/cypress/pull/31198).
+
## 14.1.0
_Released 2/25/2025_
diff --git a/docs/cloud/features/smart-orchestration/run-cancellation.mdx b/docs/cloud/features/smart-orchestration/run-cancellation.mdx
index cba34a2d47..e8323e5ad1 100644
--- a/docs/cloud/features/smart-orchestration/run-cancellation.mdx
+++ b/docs/cloud/features/smart-orchestration/run-cancellation.mdx
@@ -26,13 +26,7 @@ changes. When Auto Cancellation is enabled, once the number of failed tests goes
over a preset threshold, the entire test run is canceled. Note that any
in-progress specs will continue to run to completion.
- **Benefits:** Canceling an **entire**
-test run, even if parallelized, upon the first test failure will:
-
-1. **Save time**. Resolve test outcomes faster.
-2. **Reduce CI costs**. These cost savings can be significant for large test
- suites.
-3. **Free-up CI resources** for validating fixes, and helping other users.
+
### Activate Auto Cancellation in Cypress Cloud
diff --git a/docs/partials/_auto-cancellation-benefits.mdx b/docs/partials/_auto-cancellation-benefits.mdx
new file mode 100644
index 0000000000..21dca4fccb
--- /dev/null
+++ b/docs/partials/_auto-cancellation-benefits.mdx
@@ -0,0 +1,7 @@
+ **Benefits:** Stopping a test run on the
+first failure across parallelized machines will:
+
+1. **Save time.** Identify failures early and resolve issues faster.
+2. **Reduce CI costs.** Cut down on unnecessary test execution, leading to significant savings for large test suites.
+3. **Free up CI resources.** Prioritize critical tests and keep CI pipelines available for validating fixes.
+4. **Optimize future runs.** With **[Spec Prioritization](/cloud/features/smart-orchestration/spec-prioritization)** and **Auto Cancellation**, failed tests run first in the next attempt, stopping early if issues persist to maximize efficiency.
diff --git a/src/theme/MDXComponents.js b/src/theme/MDXComponents.js
index a8641c3acb..0e3ee1f5f0 100644
--- a/src/theme/MDXComponents.js
+++ b/src/theme/MDXComponents.js
@@ -2,6 +2,7 @@
import MDXComponents from "@theme-original/MDXComponents";
import AnatomyOfAnError from "@site/docs/partials/_anatomy-of-an-error.mdx";
import AccessibilityAddon from "@site/docs/partials/_accessibility-addon.mdx";
+import AutoCancellationBenefits from "@site/docs/partials/_auto-cancellation-benefits.mdx";
import Badge from "@site/src/components/badge";
import Btn from "@site/src/components/button";
import ComponentOnlyBadge from "@site/src/components/component-only-badge";
@@ -160,6 +161,7 @@ export default {
...MDXComponents,
AnatomyOfAnError,
AccessibilityAddon,
+ AutoCancellationBenefits,
Badge,
Btn,
ComponentOnlyBadge,
diff --git a/static/img/api/stop/cypress-stop-during-open-mode.png b/static/img/api/stop/cypress-stop-during-open-mode.png
new file mode 100644
index 0000000000..3a2c008182
Binary files /dev/null and b/static/img/api/stop/cypress-stop-during-open-mode.png differ
diff --git a/static/img/api/stop/cypress-stop-during-run-mode.png b/static/img/api/stop/cypress-stop-during-run-mode.png
new file mode 100644
index 0000000000..4f0ddbe2e7
Binary files /dev/null and b/static/img/api/stop/cypress-stop-during-run-mode.png differ