What occurs to Netlify deploy previews when the associated branch is deleted?

Question

When a branch associated with a Netlify site is removed from the repository, the site’s branch deploy preview continues to exist until its built‑in expiration timer elapses. The documentation describes automatic preview creation and configurable lifetime, but does not specify whether deleting the branch triggers an immediate cancellation or cleanup of the preview deployment. Clarifying this behavior helps teams manage preview quotas and avoid stale URLs being accessible after a branch is gone.

Does Netlify issue a cancel signal to the ongoing or already built preview when the source branch is deleted? If the preview is not cancelled, does it remain reachable until the default 24‑hour timeout (or a custom setting) expires? Is there a site‑level option to force immediate removal of previews when their branch disappears?

Tasadduq Burney · Answer

Branch Deletion and Preview Persistence
When a branch associated with a Netlify site is deleted from the remote repository, Netlify does not immediately issue a cancel signal to kill active builds or instantly purge existing preview deployments. Instead, the associated deploy preview remains reachable until the system's internal garbage collection process removes the deployment record.

Expected Behavior vs. Confirmed Facts
Based on standard Netlify deployment lifecycles, the following behaviors occur:

URL Accessibility: The unique branch deploy URL (e.g., branch-name--site-name.netlify.app) typically remains active for a short window. Once the system synchronizes the branch deletion, the endpoint will eventually return a 404 "Deploy not found" page or redirect to the main site domain.
  Cleanup Timing: There is no single "instant" trigger for removal. Deploys are generally scheduled for cleanup within a 24-to-48-hour window after the source reference is gone.
  Build Status: If a build was already in progress when the branch was deleted, it may complete its cycle, but the resulting deploy will be marked as orphaned.

Manual Cleanup and Management
Netlify does not currently provide a site-level toggle to "force immediate removal" of all previews upon branch deletion. To ensure a preview is gone immediately, you must manually intervene:

Navigate to the Deploys tab in the Netlify UI.
  Filter by the specific branch name.
  Select the deploy and choose Delete deploy.

Verification Steps
To verify the status of a preview after a branch has been deleted:

UI Check: Check the site's branch list in the Netlify dashboard; the preview badge for the deleted branch should disappear.
  Endpoint Check: Attempt to visit the specific branch URL. A 404 response confirms the deployment has been purged from the edge network.

Diagnostic Note: Are you using a custom domain for your branch deploys or the default Netlify subdomains? Custom domain configurations may alter how redirects are handled after a branch is removed.

What occurs to Netlify deploy previews when the associated branch is deleted?

1 answer

Branch Deletion and Preview Persistence

Expected Behavior vs. Confirmed Facts

Manual Cleanup and Management

Verification Steps

Your perspective belongs here.

0 question comments