Document how to restrict Office integration for SharePoint Embedded

[Dan Winter (dwinter-msft)]

Summary

Updates the SharePoint Embedded Office-launch guidance to state that Office integration is enabled by default and to explain how developers can opt out by using the isOfficeRestricted container-type setting.

Changes

• Clarifies that authorized users can open supported files through Office for the web and Office desktop clients outside an app's custom UI.
• Adds guidance for applications that require file access to remain within app-controlled experiences.
• Links to the beta Microsoft Graph fileStorageContainerTypeSettings reference for isOfficeRestricted.
• Explains at a high level that restricting Office integration removes Office web and desktop launch experiences.

Validation

• Verified the public property name and behavior against the current beta Microsoft Graph API documentation.
• Confirmed all links and Learn Markdown formatting.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

[learn-build-service-prod]

Learn Build status updates of commit 2d0177c:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
docs/docfx.json	⚠️Warning		Details
docs/embedded/build/manage-files.md	💡Suggestion	View	Details
docs/embedded/build/open-office-files.md	💡Suggestion	View	Details
docs/embedded/plan/ground-ai-without-a-vector-db.md	💡Suggestion	View	Details
docs/embedded/admin/create-apps-powershell.md	✅Succeeded	View
docs/embedded/build/agent-experiences.md	✅Succeeded	View
docs/embedded/build/configure-authentication-authorization.md	✅Succeeded	View
docs/embedded/build/create-manage-containers.md	✅Succeeded	View
docs/embedded/build/sharepoint-embedded-knowledge-source.md	✅Succeeded	View
docs/embedded/build/sharepoint-embedded-mcp-server.md	✅Succeeded	View
docs/embedded/llms.txt	✅Succeeded	View
docs/embedded/overview.md	✅Succeeded	View
docs/embedded/plan/authentication-permissions.md	✅Succeeded	View
docs/embedded/plan/container-types-containers.md	✅Succeeded	View
docs/embedded/plan/office-collaboration-instead-of-building.md	✅Succeeded	View
docs/embedded/plan/when-to-choose-sharepoint-embedded.md	✅Succeeded	View
docs/embedded/reference/audit-events.md	✅Succeeded	View
docs/embedded/reference/glossary.md	✅Succeeded	View
docs/embedded/reference/troubleshooting.md	✅Succeeded	View
docs/embedded/scenarios-and-use-cases.md	✅Succeeded	View
docs/toc.yml	✅Succeeded	View

docs/docfx.json

• Line 45, Column 33: [Warning: feedback-system-invalid - See documentation] Invalid value for 'feedback_system': 'GitHub'. The value for "feedback_system" must be either "Standard", "OpenSource" or "None".
• Line 68, Column 59: [Warning: ms-service-subservice-invalid - See documentation] Invalid value for 'ms.subservice': 'sharepoint-framework' is not valid with 'ms.service' value 'sharepoint-online'.
• Line 69, Column 44: [Warning: ms-service-subservice-invalid - See documentation] Invalid value for 'ms.subservice': 'sharepoint-framework' is not valid with 'ms.service' value 'sharepoint-online'.

docs/embedded/build/manage-files.md

• Line 156, Column 3: [Suggestion: preserve-view-not-set - See documentation] You've pinned this link to a specific version of content with the view parameter. It's recommended not to pin a version unless that version is A) not the default view and B) the context is about that version specifically. To proceed with pinning a version add the &preserve-view=true to the URL. Otherwise, remove the view parameter. URL: /graph/api/filestoragecontainer-restore-recyclebinitem?view=graph-rest-beta

docs/embedded/build/open-office-files.md

• Line 54, Column 236: [Suggestion: preserve-view-not-set - See documentation] You've pinned this link to a specific version of content with the view parameter. It's recommended not to pin a version unless that version is A) not the default view and B) the context is about that version specifically. To proceed with pinning a version add the &preserve-view=true to the URL. Otherwise, remove the view parameter. URL: /graph/api/resources/filestoragecontainertypesettings?view=graph-rest-beta

docs/embedded/plan/ground-ai-without-a-vector-db.md

• Line 0, Column 0: [Suggestion: filename-contains-stop-word - See documentation] Stop words like 'a', 'or', 'and', 'the', and 'in' are discouraged in filenames.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

[learn-build-service-prod]

Learn Build status updates of commit b55f540:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
docs/docfx.json	⚠️Warning		Details
docs/embedded/build/manage-files.md	💡Suggestion	View	Details
docs/embedded/build/open-office-files.md	💡Suggestion	View	Details
docs/embedded/plan/ground-ai-without-a-vector-db.md	💡Suggestion	View	Details
docs/embedded/admin/create-apps-powershell.md	✅Succeeded	View
docs/embedded/build/agent-experiences.md	✅Succeeded	View
docs/embedded/build/configure-authentication-authorization.md	✅Succeeded	View
docs/embedded/build/create-manage-containers.md	✅Succeeded	View
docs/embedded/build/sharepoint-embedded-knowledge-source.md	✅Succeeded	View
docs/embedded/build/sharepoint-embedded-mcp-server.md	✅Succeeded	View
docs/embedded/llms.txt	✅Succeeded	View
docs/embedded/overview.md	✅Succeeded	View
docs/embedded/plan/authentication-permissions.md	✅Succeeded	View
docs/embedded/plan/container-types-containers.md	✅Succeeded	View
docs/embedded/plan/office-collaboration-instead-of-building.md	✅Succeeded	View
docs/embedded/plan/when-to-choose-sharepoint-embedded.md	✅Succeeded	View
docs/embedded/reference/audit-events.md	✅Succeeded	View
docs/embedded/reference/glossary.md	✅Succeeded	View
docs/embedded/reference/troubleshooting.md	✅Succeeded	View
docs/embedded/scenarios-and-use-cases.md	✅Succeeded	View
docs/toc.yml	✅Succeeded	View

docs/docfx.json

• Line 45, Column 33: [Warning: feedback-system-invalid - See documentation] Invalid value for 'feedback_system': 'GitHub'. The value for "feedback_system" must be either "Standard", "OpenSource" or "None".
• Line 68, Column 59: [Warning: ms-service-subservice-invalid - See documentation] Invalid value for 'ms.subservice': 'sharepoint-framework' is not valid with 'ms.service' value 'sharepoint-online'.
• Line 69, Column 44: [Warning: ms-service-subservice-invalid - See documentation] Invalid value for 'ms.subservice': 'sharepoint-framework' is not valid with 'ms.service' value 'sharepoint-online'.

docs/embedded/build/manage-files.md

• Line 156, Column 3: [Suggestion: preserve-view-not-set - See documentation] You've pinned this link to a specific version of content with the view parameter. It's recommended not to pin a version unless that version is A) not the default view and B) the context is about that version specifically. To proceed with pinning a version add the &preserve-view=true to the URL. Otherwise, remove the view parameter. URL: /graph/api/filestoragecontainer-restore-recyclebinitem?view=graph-rest-beta

docs/embedded/build/open-office-files.md

• Line 54, Column 236: [Suggestion: preserve-view-not-set - See documentation] You've pinned this link to a specific version of content with the view parameter. It's recommended not to pin a version unless that version is A) not the default view and B) the context is about that version specifically. To proceed with pinning a version add the &preserve-view=true to the URL. Otherwise, remove the view parameter. URL: /graph/api/resources/filestoragecontainertypesettings?view=graph-rest-beta

docs/embedded/plan/ground-ai-without-a-vector-db.md

• Line 0, Column 0: [Suggestion: filename-contains-stop-word - See documentation] Stop words like 'a', 'or', 'and', 'the', and 'in' are discouraged in filenames.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

[learn-build-service-prod]

Learn Build status updates of commit 2d0177c:

💡 Validation status: suggestions

File	Status	Preview URL	Details
docs/embedded/build/open-office-files.md	💡Suggestion	View	Details

docs/embedded/build/open-office-files.md

• Line 54, Column 236: [Suggestion: preserve-view-not-set - See documentation] You've pinned this link to a specific version of content with the view parameter. It's recommended not to pin a version unless that version is A) not the default view and B) the context is about that version specifically. To proceed with pinning a version add the &preserve-view=true to the URL. Otherwise, remove the view parameter. URL: /graph/api/resources/filestoragecontainertypesettings?view=graph-rest-beta

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

[learn-build-service-prod]

Learn Build status updates of commit 2d0177c:

💡 Validation status: suggestions

File	Status	Preview URL	Details
docs/embedded/build/open-office-files.md	💡Suggestion	View	Details

docs/embedded/build/open-office-files.md

• Line 54, Column 236: [Suggestion: preserve-view-not-set - See documentation] You've pinned this link to a specific version of content with the view parameter. It's recommended not to pin a version unless that version is A) not the default view and B) the context is about that version specifically. To proceed with pinning a version add the &preserve-view=true to the URL. Otherwise, remove the view parameter. URL: /graph/api/resources/filestoragecontainertypesettings?view=graph-rest-beta

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

[learn-build-service-prod]

Learn Build status updates of commit c576315:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/embedded/build/open-office-files.md	✅Succeeded	View

For more details, please refer to the build report.

[ShreyasSar26]

Documentation review — restrict Office integration

Reviewed against the Microsoft Graph fileStorageContainerTypeSettings reference. Overall this is accurate and reads well — no blockers. A few suggestions:

Beta-only capability isn't called out (accuracy)
isOfficeRestricted currently exists only in graph-rest-beta — it's absent from the v1.0 fileStorageContainerTypeSettings resource. The rest of this article uses v1.0 endpoints (e.g. the urlTemplate PATCH targets graph.microsoft.com/v1.0/...). The cross-link correctly uses &preserve-view=true, but readers will likely try this against v1.0 and hit a failure. Consider stating explicitly that this setting is currently available through the beta endpoint.

No concrete API example for setting the property (completeness)
The new section tells readers to set isOfficeRestricted to true but shows no request, whereas the parallel urlTemplate section provides a full PATCH .../containerTypes/{id} example. Adding an analogous PATCH snippet (a settings object with "isOfficeRestricted": true) would make the section actionable on its own.

Redundant "enabled by default" (style)
"Office integration is enabled by default" appears in the new NOTE and again as the first sentence of Control Office integration, within a few lines. Consider dropping one.

Stacked consecutive NOTE blocks (style)
The new NOTE sits directly above the existing "archived container" NOTE, creating two back-to-back alerts. Microsoft style discourages stacking alerts — consider folding the default-behavior context into the section prose (it partly duplicates the section) and reserving alerts for true asides.

Long NOTE / wording (style, minor)
The added NOTE is a dense multi-sentence paragraph (alerts should stay short), and "supported API surface" reads a little awkwardly. Minor tightening would help.

Confirmed correct

• isOfficeRestricted is a real Boolean on fileStorageContainerTypeSettings (beta) that restricts Office apps (Word, Excel, PowerPoint) for desktop and web — the behavior description matches.
• Container-type scoping ("affected containers") is accurate; it's a type-level setting.
• Default-off framing is correct (the property defaults to false).
• Cross-link syntax and preserve-view usage are correct.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

[learn-build-service-prod]

Learn Build status updates of commit 252df4b:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/embedded/build/open-office-files.md	✅Succeeded	View

For more details, please refer to the build report.