Enterprise-grade Edge won't enable in Azure Static Web Apps

Question

enterprise grade edge won't enable via the dashboard. I've tried twice already. It says in progress, for about twenty minutes. I click on refresh and the box is unchecked.

simple hugo static site on custom domain. Any insights?

Answer 1

Hi @Ron Spinabella

Thanks for sharing the root cause.

Incorrect or unsupported cache directives in staticwebapp.config.json can interfere with Enterprise‑grade Edge provisioning. Enterprise‑grade Edge is powered by Azure Front Door, which evaluates routing and cache‑control configuration as part of setup. When cache headers are misconfigured or unsupported, Azure Front Door may be unable to complete validation, which can cause the enablement process to fail without an explicit portal error.

After correcting the cache configuration, Enterprise‑grade Edge was able to provision successfully, confirming the issue was configuration‑related rather than DNS or platform‑related.

reference:

https://learn.microsoft.com/en-us/azure/static-web-apps/configuration

https://learn.microsoft.com/en-us/azure/static-web-apps/enterprise-edge?tabs=azure-portal

 Please do not forget to click "Accept the answer” and Yes, this can be beneficial to other community members.

If you have any other questions, let me know in the "comments" and I would be happy to help you

Answer 2

Enterprise-grade edge can only be enabled when all prerequisites are met and the platform can successfully attach Azure Front Door. When the portal shows “In progress” and then silently unchecks, the most common causes are:

1. Plan or resource prerequisites not satisfied
   Enterprise-grade edge requires:
   • A Static Web App on the Standard plan (not Free).
   • A custom domain configured with TTL < 48 hours.
   Verify in the Static Web App:
   1. In the Azure portal, open the Static Web App.
   2. On Overview, confirm the SKU/plan is Standard.
   3. On Custom domains, confirm at least one custom domain is successfully added and validated.
2. Microsoft.CDN resource provider not registered
   Enabling enterprise-grade edge uses Azure Front Door and requires the Microsoft.CDN resource provider to be registered in the subscription. If it is not, the operation can fail and revert. Use Azure CLI to both register and enable, which surfaces errors more clearly:

      # 1. Ensure the extension is installed
      az extension add --name enterprise-edge
      
      # 2. (Recommended) Let the command auto-register Microsoft.CDN
      az staticwebapp enterprise-edge enable \
        --name <your-static-webapp-name> \
        --resource-group <your-resource-group>
   

   If auto-registration is disabled or fails, register manually:

      az provider register --wait --namespace Microsoft.CDN
      
      az staticwebapp enterprise-edge enable \
        --name <your-static-webapp-name> \
        --resource-group <your-resource-group>
   

   If this command fails, the CLI output will show the exact error (for example, missing provider registration or permission issues).
3. Check limitations and configuration
   • Private Endpoint cannot be used with enterprise-grade edge. If the Static Web App is configured with a private endpoint, disable that scenario before enabling enterprise-grade edge.
   • Ensure the custom domain is not in the middle of DNS changes with very high previous TTLs; DNS-related operations (especially around custom domains) can take time to propagate.
4. Confirm from metrics once enabled
   After a successful enable, the CdnRequestCount and other CDN-related metrics appear under Monitoring → metrics for the Static Web App. This helps verify that traffic is flowing through enterprise-grade edge.

If the portal keeps reverting with no visible error, running the az staticwebapp enterprise-edge enable command is the most direct way to see the underlying failure reason and confirm whether it is a plan, provider registration, or configuration limitation issue.

---

References:

• Enterprise-grade edge
• Tutorial: Configure a CDN for Azure Static Web Apps (swa-afd-enterprise-grade-edge)
• Custom domains with Azure Static Web Apps
• az staticwebapp enterprise-edge enable
• Supported metrics for managed Functions in Azure Static Web Apps