EDI-ify "Control the concurrency of workflows and jobs" (#56674)

sabrowning1 · web-flow · commit 4018c3baa9ff · 2025-07-17T17:39:20.000Z
diff --git a/content/actions/concepts/workflows-and-actions/concurrency.md b/content/actions/concepts/workflows-and-actions/concurrency.md
@@ -0,0 +1,18 @@
+---
+title: Concurrency
+intro: 'Learn about running workflows and jobs simultaneously.'
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+type: overview
+topics:
+  - Actions
+  - Workflows
+---
+
+By default, {% data variables.product.prodname_actions %} allows multiple jobs within the same workflow, multiple workflow runs within the same repository, and multiple workflow runs across a repository owner's account to run concurrently. This means that multiple instances of the same workflow or job can run at the same time, performing the same steps.
+
+{% data variables.product.prodname_actions %} also allows you to disable concurrent execution. This can be useful for controlling your account’s or organization’s resources in situations where running multiple workflows or jobs at the same time could cause conflicts or consume more Actions minutes and storage than expected. For example, you might want to prevent multiple deployments from running at the same time, or cancel linters checking outdated commits.
+
+To start controlling concurrency in your own workflows with the `concurrency` keyword, see [AUTOTITLE](/actions/how-tos/writing-workflows/choosing-when-your-workflow-runs/control-the-concurrency-of-workflows-and-jobs).
diff --git a/content/actions/concepts/workflows-and-actions/index.md b/content/actions/concepts/workflows-and-actions/index.md
@@ -14,6 +14,7 @@ children:
   - /contexts
   - /expressions
   - /deployment-environments
+  - /concurrency
   - /workflow-artifacts
   - /dependency-caching
   - /about-monitoring-workflows
diff --git a/content/actions/how-tos/writing-workflows/choosing-what-your-workflow-does/control-the-concurrency-of-workflows-and-jobs.md b/content/actions/how-tos/writing-workflows/choosing-what-your-workflow-does/control-the-concurrency-of-workflows-and-jobs.md
diff --git a/content/actions/how-tos/writing-workflows/choosing-what-your-workflow-does/index.md b/content/actions/how-tos/writing-workflows/choosing-what-your-workflow-does/index.md
@@ -19,7 +19,5 @@ children:
   - /passing-information-between-jobs
   - /setting-a-default-shell-and-working-directory
   - /deploying-to-a-specific-environment
-  - /control-the-concurrency-of-workflows-and-jobs
   - /running-variations-of-jobs-in-a-workflow
 ---
-
diff --git a/content/actions/how-tos/writing-workflows/choosing-when-your-workflow-runs/control-the-concurrency-of-workflows-and-jobs.md b/content/actions/how-tos/writing-workflows/choosing-when-your-workflow-runs/control-the-concurrency-of-workflows-and-jobs.md
@@ -0,0 +1,26 @@
+---
+title: Control the concurrency of workflows and jobs
+shortTitle: Control workflow concurrency
+intro: Manage which workflows and jobs can run simultaneously.
+versions:
+  fpt: '*'
+  ghes: '*'
+  ghec: '*'
+redirect_from:
+  - /actions/using-jobs/using-concurrency
+  - /actions/writing-workflows/choosing-what-your-workflow-does/using-concurrency
+  - /early-access/actions/running-additional-jobs-in-github-actions
+  - /actions/writing-workflows/choosing-what-your-workflow-does/control-the-concurrency-of-workflows-and-jobs
+  - /actions/how-tos/writing-workflows/choosing-what-your-workflow-does/control-the-concurrency-of-workflows-and-jobs
+---
+
+## Using concurrency in different scenarios
+
+{% data reusables.actions.jobs.section-using-concurrency-jobs %}
+
+{% ifversion github-runner-dashboard %}
+
+## Monitoring your current jobs in your organization or enterprise
+
+{% data reusables.actions.github-hosted-runners-check-concurrency %}
+{% endif %}
diff --git a/content/actions/how-tos/writing-workflows/choosing-when-your-workflow-runs/index.md b/content/actions/how-tos/writing-workflows/choosing-when-your-workflow-runs/index.md
@@ -9,7 +9,7 @@ versions:
 children:
   - /triggering-a-workflow
   - /using-conditions-to-control-job-execution
+  - /control-the-concurrency-of-workflows-and-jobs
 redirect_from:
   - /actions/writing-workflows/choosing-when-your-workflow-runs
 ---
-
