pixelbrackets
diff --git a/‎assets/images/help/codespaces/prebuilds-delete.png‎
9.73 KB b/‎assets/images/help/codespaces/prebuilds-delete.png‎
9.73 KB
diff --git a/‎assets/images/help/codespaces/prebuilds-disable.png‎
39 KB b/‎assets/images/help/codespaces/prebuilds-disable.png‎
39 KB
diff --git a/‎assets/images/help/codespaces/prebuilds-edit.png‎
-795 Bytes b/‎assets/images/help/codespaces/prebuilds-edit.png‎
-795 Bytes
diff --git a/‎assets/images/help/codespaces/prebuilds-manually-trigger.png‎
-3.53 KB b/‎assets/images/help/codespaces/prebuilds-manually-trigger.png‎
-3.53 KB
diff --git a/‎assets/images/help/codespaces/prebuilds-view-runs.png‎
-1.31 KB b/‎assets/images/help/codespaces/prebuilds-view-runs.png‎
-1.31 KB
diff --git a/‎content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md‎
Lines changed: 14 additions & 1 deletion b/‎content/codespaces/prebuilding-your-codespaces/managing-prebuilds.md‎
Lines changed: 14 additions & 1 deletion
diff --git a/‎content/codespaces/troubleshooting/troubleshooting-prebuilds.md‎
Lines changed: 4 additions & 0 deletions b/‎content/codespaces/troubleshooting/troubleshooting-prebuilds.md‎
Lines changed: 4 additions & 0 deletions
@@ -58,7 +58,20 @@ This displays the workflow run history for prebuilds for the associated branch.
 
 1. Make the required changes to the prebuild configuration, then click **Update**. 
 
-### Delete a prebuild configuration
+### Disabling a prebuild configuration
+
+To pause the update of prebuild templates for a configuration, you can disable workflow runs for the configuration. Disabling the workflow runs for a prebuild configuration does not delete any previously created prebuild templates for that configuration and, as a result, codespaces will continue to be generated from an existing prebuild template.
+
+Disabling the workflow runs for a prebuild configuration is useful if you need to investigate template creation failures.
+
+1. On the {% data variables.product.prodname_codespaces %} page of your repository settings, click the ellipsis to the right of the prebuild configuration you want to disable.
+1. In the dropdown menu, click **Disable runs**.
+
+   ![The 'Disable runs' option in the drop-down menu](/assets/images/help/codespaces/prebuilds-disable.png)
+
+1. To confirm that you want to disable this configuration, click **OK**.
+
+### Deleting a prebuild configuration
 
 Deleting a prebuild configuration also deletes all previously created prebuild templates for that configuration. As a result, shortly after you delete a configuration, prebuilds generated by that configuration will no longer be available when you create a new codespace.
 
 
@@ -57,6 +57,10 @@ Here are things to check if the "{% octicon "zap" aria-label="The zap icon" %} P
 * Check whether a change to the dev container configuration was pushed to the prebuild-enabled branch recently. If so, you will typically have to wait until the prebuild workflow run for this push completes before prebuilds are available again.
 * If no configuration changes were recently made, go to the **Actions** tab of your repository, click **{% octicon "codespaces" aria-label="The Codespaces icon" %} {% data variables.product.prodname_codespaces %} Prebuilds** in the workflows list, and check that prebuild workflow runs for the branch are succeeding. If latest runs of a workflow failed, and one or more of these failed runs contained changes to the dev container configuration, then there will be no available prebuilds for the associated branch. 
 
+## Troubleshooting failed workflow runs for prebuilds
+
+If the workflow runs for a prebuild configuration are failing, you can temporarily disable the prebuild configuration while you investigate. For more information, see "[Managing prebuilds](/codespaces/prebuilding-your-codespaces/managing-prebuilds#disabling-a-prebuild-configuration)."
+
 ## Further reading
 
 - "[Configuring prebuilds](/codespaces/prebuilding-your-codespaces/configuring-prebuilds)"