Skip to content

Update manage-app-consent-policies.md#1941

Open
sachinatraj wants to merge 1 commit intoMicrosoftDocs:mainfrom
sachinatraj:patch-1
Open

Update manage-app-consent-policies.md#1941
sachinatraj wants to merge 1 commit intoMicrosoftDocs:mainfrom
sachinatraj:patch-1

Conversation

@sachinatraj
Copy link
Copy Markdown

As requested by the user, a new "Note" has been added under the Mail client policy to avoid the misunderstanding that admin consent will be possible for all permissions when the default mail client policy is applied.

As requested by the user, a new "Note" has been added under the Mail client policy to avoid the misunderstanding that admin consent will be possible for all permissions when the default mail client policy is applied.
@prmerger-automator
Copy link
Copy Markdown
Contributor

@sachinatraj : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 3919b90:

✅ Validation status: passed

File Status Preview URL Details
docs/identity/enterprise-apps/manage-app-consent-policies.md ✅Succeeded

For more details, please refer to the build report.

@ttorble ttorble requested a review from Copilot April 6, 2026 15:52
@ttorble
Copy link
Copy Markdown
Contributor

ttorble commented Apr 6, 2026

@omondiatieno

Can you review the proposed changes?

IMPORTANT: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the Microsoft Entra documentation for app consent policies to clarify the scope of the default mail client consent policy, reducing confusion about when admin consent is still required.

Changes:

  • Adds a Note under the “Mail client policy” section to clarify that the policy only covers a limited set of delegated mail permissions for specific mail clients.
  • Clarifies that admin consent can still be required when requested permissions fall outside that policy’s scope.

Comment on lines +72 to +73
>The Mail client policy (microsoft-user-allow-default-consent-apps) allows end users to consent only to a limited set of delegated mail-related permissions for specific mail client applications.
Therefore, even when this policy is enabled, administrator consent may still be required if an application requests permissions that are outside the scope of the Mail client policy.
Copy link

Copilot AI Apr 6, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The admonition formatting is broken: line 72 is missing a space after > and line 73 isn’t prefixed with > at all, so the second sentence renders outside the Note block. Prefix each content line with > so the entire note is included.

Suggested change
>The Mail client policy (microsoft-user-allow-default-consent-apps) allows end users to consent only to a limited set of delegated mail-related permissions for specific mail client applications.
Therefore, even when this policy is enabled, administrator consent may still be required if an application requests permissions that are outside the scope of the Mail client policy.
> The Mail client policy (microsoft-user-allow-default-consent-apps) allows end users to consent only to a limited set of delegated mail-related permissions for specific mail client applications.
> Therefore, even when this policy is enabled, administrator consent may still be required if an application requests permissions that are outside the scope of the Mail client policy.

Copilot uses AI. Check for mistakes.
Comment on lines +72 to +73
>The Mail client policy (microsoft-user-allow-default-consent-apps) allows end users to consent only to a limited set of delegated mail-related permissions for specific mail client applications.
Therefore, even when this policy is enabled, administrator consent may still be required if an application requests permissions that are outside the scope of the Mail client policy.
Copy link

Copilot AI Apr 6, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Style tweaks for consistency with Microsoft Writing Style Guide: use "might" (not "may") for possibility, and format the policy ID microsoft-user-allow-default-consent-apps as code (backticks) since it’s an identifier.

Suggested change
>The Mail client policy (microsoft-user-allow-default-consent-apps) allows end users to consent only to a limited set of delegated mail-related permissions for specific mail client applications.
Therefore, even when this policy is enabled, administrator consent may still be required if an application requests permissions that are outside the scope of the Mail client policy.
>The Mail client policy (`microsoft-user-allow-default-consent-apps`) allows end users to consent only to a limited set of delegated mail-related permissions for specific mail client applications.
Therefore, even when this policy is enabled, administrator consent might still be required if an application requests permissions that are outside the scope of the Mail client policy.

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants