From 0015ff0fdb55478f337b492aec175f9d92a18672 Mon Sep 17 00:00:00 2001 From: JulianMaurin Date: Wed, 1 Apr 2026 18:42:00 +0200 Subject: [PATCH] docs: add deprecation banner to delete_head_branch action The delete_head_branch action is deprecated (engine#27721) and will be removed on June 30, 2026. Users should use GitHub's built-in auto-delete branches setting instead. Refs: MRGFY-6799 Co-Authored-By: Claude Opus 4.6 (1M context) Change-Id: I86761e73de36c68ad13a723a17628acdd39bd221 --- src/content/docs/workflow/actions/delete_head_branch.mdx | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/src/content/docs/workflow/actions/delete_head_branch.mdx b/src/content/docs/workflow/actions/delete_head_branch.mdx index 3b54ab4561..c2fa4451f8 100644 --- a/src/content/docs/workflow/actions/delete_head_branch.mdx +++ b/src/content/docs/workflow/actions/delete_head_branch.mdx @@ -5,6 +5,13 @@ description: Delete pull request head branch. Useful to clean pull requests once import ActionOptionsTable from '../../../../components/Tables/ActionOptionsTable'; +:::danger + The `delete_head_branch` action is **deprecated** and will be removed on + June 30, 2026. Use GitHub's built-in [automatically delete head + branches](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-the-automatic-deletion-of-branches) + setting instead. +::: + The `delete_head_branch` action allows Mergify to automatically delete the head branch of a pull request once it has been merged. This can be useful for maintaining a clean repository and reducing clutter from unused branches.