Azure Blueprints (Preview) is being retired, and this time the shutdown is phased. The first restriction is already live, and the next one lands on 31 October 2026. If your landing zones or subscription baselines were built with Blueprints, the time to plan the move is now.
The four dates that matter
Microsoft first announced the retirement on 14 September 2023 with an end date of 11 July 2026. That was extended to 31 January 2027, with restrictions switching on in stages. (Microsoft Learn)
| Date | What changes |
|---|---|
| 31 July 2026 (already in effect) | You can no longer create new blueprint definitions or versions. |
| 31 October 2026 | Existing definitions can no longer be modified, and you can no longer create new blueprint assignments. |
| 31 December 2026 | Existing blueprint assignments can no longer be modified. |
| 31 January 2027 | Blueprints is retired. The API stops responding, Azure CLI and PowerShell commands stop working, and Blueprints is removed from the portal. |
What happens on 31 January 2027
- Your resources stay. Anything deployed through a blueprint is not deleted.
- Unexported blueprints are deleted. Definitions, versions and assignments that you haven't exported are removed permanently and can't be recovered.
- Blueprint locks stop working. "Do Not Delete" and "Read Only" locks applied by blueprints stop protecting your resources.
The lock change is the one that bites. If a production resource group is protected only by a blueprint lock, it becomes unprotected on retirement day, with no warning in the portal. Replace those locks before then.
Find out where you use Blueprints
- Azure Advisor shows a recommendation listing the subscriptions and management groups where Blueprints is in use.
- The Blueprints blade in the Azure portal lists your definitions and assignments.
- Search your pipelines and scripts for
az blueprintand Blueprint PowerShell cmdlets. Theaz blueprintcommand group is already deprecated and is due to be removed in Azure CLI 2.92.0, scheduled for November 2026. (Azure CLI breaking changes)
What replaces it
Blueprints did two jobs. Microsoft has split them across two generally available features that you use together. (Microsoft Learn)
| Blueprints concept | Replacement |
|---|---|
| Blueprint definition (stored, versioned artifacts) | Template specs, or Bicep/ARM files in a Git repository |
| Blueprint assignment (deploy and manage as a unit) | Azure Deployment Stacks (recommended) |
| Blueprint locks | Deployment stack deny settings |
| Policy and role assignment artifacts | Policy and role assignment resources written in Bicep or ARM |
| Scope: subscription or management group | Stacks work at resource group, subscription and management group scope |
A migration checklist
- Inventory now. List every definition and assignment, its scope, and who owns it. Do this before 31 October, while you can still change things.
- Export everything you want to keep. Unexported definitions are deleted at retirement.
- Convert the artifacts to Bicep or ARM templates: policy assignments, role assignments and resource templates. Microsoft's migration guide walks through it.
- Store them as template specs, or in Git if you already review infrastructure changes through pull requests.
- Deploy them as deployment stacks at the same scope, with deny settings that match your old locks.
- Test in a non-production subscription first, then compare the result with the blueprint assignment it replaces.
- Update pipelines and runbooks that call
az blueprintor Blueprint cmdlets. - Remove the old assignments once the stacks are in place and verified. Do it before 31 December, when assignments freeze.
Need a hand?
Moving governance baselines safely is part of my Azure architecture consulting. If you'd rather learn it yourself, my upcoming short course Azure Policy & Governance in Practice covers policy, deny settings and deployment stacks.
Sources
- Azure Blueprints retirement (Microsoft Learn): phased timeline and replacement guidance
- Azure Blueprints retirement FAQ (Microsoft Learn)
- Migrate blueprints to deployment stacks (Microsoft Learn)
- Upcoming breaking changes in Azure CLI (Microsoft Learn):
az blueprintremoval