Fix an Azure Web App Not Displaying in a SharePoint Embed Web Part
Question details
Determine why an Azure Web App that opens directly in a browser does not display in a SharePoint Embed web part.

- Product
- Microsoft SharePoint and Azure App Service
- Device & OS
- not provided
- Scenario
- A user wants to display an Azure-hosted web app within a SharePoint page using an HTTPS iframe.
- Observed behavior
- The web app works when opened directly but may not appear inside the SharePoint Embed web part.
Have the Azure Web App's HTTPS URL and the SharePoint page URL ready. You may need permission to edit the SharePoint page and access the app's response headers or configuration.
Test the Embed Web Part and Verify the App URL
Use a known embeddable HTTPS page to distinguish a general SharePoint embedding issue from an Azure Web App issue.
Open the Azure Web App's HTTPS URL in a browser and confirm that it loads without certificate errors or redirects to HTTP.
Edit the SharePoint page, select the Embed web part, and enter the HTTPS URL of a page known to permit iframe embedding. Publish or republish the page and check whether it displays.
If SharePoint reports that the domain is not allowed, ask a site collection administrator to review Site settings > HTML Field Security and allow the required domain according to your organization's policy.
Return to the Embed web part and replace the test URL with the Azure Web App's HTTPS URL. If the test page works but the app does not, inspect the app's response headers.

Inspect Azure Web App Iframe Security Headers
Use this method when the SharePoint web part works with a permitted test page but the Azure app remains blank or reports a framing error.
Work with Office Documents Alongside Your SharePoint Workflow
WPS Office is a free, lightweight alternative for everyday document work. Its familiar interface and support for Microsoft Office formats make it easy to move existing files into your workflow. It does not change SharePoint or Azure iframe settings.

Frequently Asked Questions
Why does the Azure app open directly but not inside SharePoint?
Direct access and iframe access are treated differently. Check the browser Console and the app's Network response headers for X-Frame-Options or a Content-Security-Policy frame-ancestors directive that blocks the SharePoint page.
Does the Embed web part require HTTPS?
Use an HTTPS URL in the SharePoint Embed web part. Also check that the app's certificate is valid and that redirects do not send the iframe to an HTTP address.
Where can I allow the app's domain in SharePoint?
A site collection administrator can review Site settings > HTML Field Security and allow the app's domain if the organization's policy permits it. This does not override the app's own iframe security headers.
What if the test website also fails to display?
Check the SharePoint error message and allowed-domain settings, and make sure the test site permits iframe embedding. A test site that blocks framing cannot establish whether the Azure app is configured correctly.
What should I do if the app still will not load?
Collect the SharePoint error, browser Console message, and relevant response headers, then ask the Azure app administrator or a SharePoint support forum for help. Avoid sharing credentials or sensitive URLs.




