SharePoint Web Parts Essentials
CNX User Diagnostics
Troubleshoot language, time zone, permissions, licenses and browser behavior for the signed-in user.
Overview
CNX User Diagnostics helps your support team find out why SharePoint looks or works differently for one person. Add it to a help page, and anyone who reports a problem can open it to see the details that shape their experience: their language and regional settings, time zones, groups, permissions, licenses, browser, device and connection, all in one place.
It does the detective work, too. It compares the language and time zone settings from the browser, SharePoint and Microsoft 365, flags the ones that don't match, and suggests how to fix them. Every value shows where it came from, and anything it can't read is clearly labeled, never guessed.
Basic diagnostics use only SharePoint and the browser, so they work as soon as the web part is on the page. Turn on enhanced diagnostics to add each person's Microsoft 365 profile, groups, roles and licenses: people are asked before anything is read from their account.
Privacy is built in. Everything runs in the person's browser, nothing is sent to CanoeUX or any other service, and sensitive values such as email addresses and IDs are hidden by default. When they're ready, people copy a short support summary or download a report for your support team, so every ticket starts with the facts.
Turn on AI assistance, and an AI assistant explains the results in plain language, answers questions about them, and drafts a support request people can paste into a ticket, using only a masked summary that never names the person or your organization.
Features
Eleven troubleshooting categories on one page
Diagnostics are grouped into sections that people expand as they need them: Overview, Language and locale, Time and region, Groups, Roles and permissions, Licenses, Device and browser, Network, SharePoint context, Request and session context and Raw diagnostics. Overview sums up the most useful signals, and Refresh diagnostics checks everything again after a change. Each value shows where it came from, and one that can't be read says why, such as Permission required.

Export the results for your support or development team
When someone reports a problem, they open Raw diagnostics and share their results the way your team prefers: Copy support summary for a short summary to paste into a ticket, chat or email, Download report (.md) or Open printable report for the full details, or Copy JSON and Download JSON for developers. The summary highlights language mismatches and failed requests, with the correlation IDs your team needs to investigate them. Sensitive values stay masked in every export unless the person chooses to show them.

Language and time zone mismatches, explained
In Language and locale, the language comparison puts every language and regional format signal side by side, from the browser, the SharePoint profile and site, and Microsoft 365, and flags the ones that differ from the language SharePoint is displaying. Its findings explain what each difference changes, and it suggests troubleshooting steps to try.

Time and region compares time zones the same way: the device's, the SharePoint profile's, the site's and the mailbox's. It also shows the site's regional settings and samples of dates, times and numbers in the browser's format, so it's easy to see why a date or time looks wrong.

Groups, roles and licenses at a glance
See the person's SharePoint site groups, the permission level each one grants and their own permissions on the site and, with enhanced diagnostics, their Microsoft Entra and Microsoft 365 groups (direct and inherited), active directory roles, and Microsoft 365 licenses with their service plans. It's the quickest way to understand why someone can't open a site or doesn't see an app they expect.

Explained by AI, when you want it
With AI assistance turned on, an AI assistant card appears above the sections. Explain with AI gives an overall status (Looks healthy, Needs attention or Problem found), a plain-language summary and the steps to try, most important first. Ask about these results answers questions such as why some pages are in French, and Draft a support request writes a subject and description, ready to paste into a help desk ticket. Answers follow the page's language.
Private by design
Everything is collected in the person's browser. Nothing is sent to CanoeUX or any other service, and nothing is kept after they leave the page. Microsoft 365 data is read only if they agree, email addresses, IDs, URLs and IP addresses are hidden by default, and access tokens, cookies and authorization headers are never read, shown or exported. AI assistance is off by default, and even when it's on, nothing goes to AI until someone selects an AI action: then only a masked digest is sent to your organization's own SharePoint AI Gateway, with no name, email address, ID, URL or group name.
Configuration
After the CanoeUX SharePoint Web Parts Essentials package has been deployed to your SharePoint tenant, you can add CNX User Diagnostics to any modern SharePoint page and configure it to help people troubleshoot their SharePoint experience.
Step 1: Edit the page
Go to the SharePoint page where you want to add the web part, such as your help or support page, and select Edit.
Important: The Edit button is in the upper-right corner of the page. If you don't see it, you don't have permission to edit the page: ask the site owner or a site administrator for edit permissions.
Step 2: Add a new web part
Hover over the section where you want the web part to appear, and select + Add a new web part.
Tip: The diagnostic tables are easiest to read in a full-width or one-column section. In narrow columns and on phones, their rows stack as cards.
Step 3: Select CNX User Diagnostics
In the web part toolbox, search for CNX User Diagnostics, and select it to add it to the page. It starts collecting diagnostics for you straight away, so you can check the results as you configure it.
Step 4: Open the property pane
Select the web part, and then select Edit properties in its toolbar.

The property pane has five sections: Sections, Privacy and data, Network, Display and export and AI assistance. SharePoint may add its own sections, such as Visibility, below them. The defaults suit most pages, and your changes appear on the page as you make them.
Step 5: Configure the Sections section
Expand Sections to choose which diagnostics people see, and whether one of them opens automatically.

Available options
Show sections
Each section of the web part has its own toggle, from Show Overview to Show Raw diagnostics. All eleven are on by default. Turn off the ones your support team doesn't need, to keep the page short.
Important: The copy and download buttons are in Raw diagnostics. Keep Show Raw diagnostics on if people need to share their results with your team.
Section expanded by default
Sections start collapsed by default (None), so people see the whole list first. To open one automatically, such as Overview or Language and locale, choose it here. The list offers only the sections that are shown.
Step 6: Configure the Privacy and data section
Expand Privacy and data to choose what the web part may read, and how much it shows.

Tip: Whatever you choose, everything stays in the person's browser. Nothing is sent to CanoeUX or any other service, and access tokens, cookies and authorization headers are never read, shown or exported.
Available options
Enable enhanced Microsoft Graph diagnostics
On by default. Adds details from Microsoft 365 through Microsoft Graph: the person's profile and preferred language, their mailbox language and time zone, their presence, their Microsoft Entra and Microsoft 365 groups, their directory roles and their licenses.
Nothing is read until each person agrees. A notice explains what's read, with Include enhanced diagnostics and Basic diagnostics only buttons, and their choice lasts until they close the browser tab.
Turn it off for basic diagnostics only, from SharePoint and the browser: no notice is shown, and Microsoft Graph is never called. SharePoint site groups and site permissions are still shown.
Important: Enhanced diagnostics need API permissions that an administrator approves once for your organization. See Approve API access below.
Hide sensitive values by default
On by default. Masks email addresses and user names, user, tenant, site and list IDs, site URLs and public IP addresses, on screen and in every copy and download.
People can turn off Hide sensitive values at the top of the web part when your support team needs the exact values. They're asked to confirm first, and reminded to share them only with people they trust.
Include WebGL renderer (privacy-sensitive)
Off by default. Adds the graphics hardware reported by the browser to Device and browser, which can help with display problems. It's privacy-sensitive because it makes a device easier to identify, so turn it on only when you need it.
Step 7: Configure the Network section
Expand Network to choose which connection checks run.

Available options
Run connectivity and latency tests
On by default. Measures how quickly SharePoint and, with enhanced diagnostics, Microsoft Graph respond, with three small read-only requests to each, and shows the median in Network. Turn it off to show only the browser's own connection estimates, such as the connection type and round-trip time.
Enable public IP lookup
Off by default. Shows the public IP address people connect from, which helps when Conditional Access or network rules depend on location. Browsers don't reveal it, so the web part asks an endpoint that you host and approve, such as an Azure Function. When you turn it on, two boxes appear:
- Allowed endpoint host names: the host names your endpoint may use, separated by commas, such as diagnostics-contoso.azurewebsites.net.
- Approved endpoint URL (HTTPS): the address of your endpoint, starting with https://. Its host name must match one of the allowed host names exactly.
The endpoint must return the IP address on its own, or a JSON object whose ip property holds it. Any other response is rejected. If the setup is incomplete, Network shows Not configured and explains why.
Important: The endpoint sees the IP address of everyone who opens the page. Use only a service your organization approves, document how long it keeps its logs, and let people know. If your tenant enforces a Content Security Policy, allow the endpoint's host name there too.
Step 8: Configure the Display and export section
Expand Display and export to choose what people can copy and download, and where they can get help.

Available options
Show raw JSON view
On by default. Shows the sanitized results as JSON in Raw diagnostics, for developers and support engineers. Turn it off to hide the JSON: people can still copy and download their results.
Allow copy and download
On by default. Shows the Copy JSON, Download JSON, Download report (.md), Copy support summary and Open printable report buttons in Raw diagnostics. Turn it off if the results should only be viewed on screen.
Show debug details to site owners
Off by default. Adds the error messages of failed requests to Request and session context. Only site owners, site collection administrators and others who can manage permissions on the site see them.
Support or help URL (HTTPS)
Optional. Adds a Contact support link beside Hide sensitive values, which opens your service desk, support form or help page in a new tab. The address must start with https://.
Cache duration (minutes)
How long results are kept in the browser's memory, from 0 to 30 minutes (5 by default), so they aren't collected again each time the web part is displayed. They're never saved, and Refresh diagnostics always collects new ones. Set it to 0 to turn caching off.
Step 9: Configure the AI assistance section
Expand AI assistance and turn on Enable AI features to show the AI assistant card above the sections. It's off by default.
- Explain with AI: an overall status, a plain-language summary, and what to look at, with steps to try.
- Ask about these results: questions about the diagnostics, with earlier answers kept as context.
- Draft a support request: a subject and description, written in the first person, ready to copy into a help desk ticket.
Answers follow the page's language, and Refresh diagnostics clears them. Only a masked digest of the results is sent: never the person's name, email address, IDs, URLs or group names.
Important: AI features need the SharePoint AI Gateway, which an administrator connects once for the whole organization with CNX Azure AI Setup. Until it's connected, the AI options stay hidden, and page editors see a message that explains why. Nothing is sent to AI until an editor selects an AI action.
Step 10: Approve API access
Enhanced diagnostics read the signed-in person's own Microsoft 365 information through Microsoft Graph. The package requests these delegated permissions, which an administrator approves once for your whole organization:
- User.Read: their profile, preferred language and licenses, and the groups they own.
- MailboxSettings.Read: the language and time zone of their mailbox. It can't read any mail.
- Presence.Read: their presence status.
- GroupMember.Read.All, optional: the names and types of their groups. Without it, groups are listed by ID only, marked Limited details.
If they've already been approved, or if you turned off enhanced diagnostics, skip this step.
- Open the SharePoint admin center, and then go to Advanced > API access.
- Under Pending requests, select a request from CanoeUX SharePoint Web Parts Essentials.
- Review the permission, and then select Approve.
- Repeat for User.Read, MailboxSettings.Read, Presence.Read and, if you choose, GroupMember.Read.All.
Important: API permissions are granted to every SharePoint Framework solution in your organization, not only this package. GroupMember.Read.All lets them read all group memberships in your directory, so approve it only if that's acceptable.
Tip: The package may list other pending requests, such as Mail.Send. Other web parts in the package use them; CNX User Diagnostics doesn't need them.
Approvals can take a few minutes to apply. Until then, Microsoft 365 values show Permission required and basic diagnostics work as usual. Once they're approved, select Refresh diagnostics.
Step 11: Publish the page
- Back on the page that holds the web part, select Republish (or Publish, if the page has never been published) to save your changes and make the page available.
- Open the published page, choose Include enhanced diagnostics if you use them, and check the results in each section.
CNX User Diagnostics is now configured and ready to use. Share the page's link with your service desk, so they can ask people to open it when they report a problem.
Limits
What browsers don't reveal
- Browsers don't let web pages read a computer's name, serial number, installed software, exact memory or processor, Wi-Fi network, MAC address or local IP address, so CNX User Diagnostics doesn't try to.
- It can't tell whether an operating system setting or an enterprise policy forced a language: it sees only the result.
Device and browser estimates
- Windows 10 and Windows 11 report themselves the same way. Microsoft Edge, Google Chrome and other Chromium browsers can tell them apart; Firefox and Safari can't.
- Browsers freeze the macOS version they report, and iPads present themselves as Macs, so the operating system and device type are estimates.
- Memory and connection details are available only in Chromium browsers, and are rounded for privacy.
Microsoft 365 and SharePoint details
- Browsers name time zones differently from SharePoint and Exchange, so time zones are compared by their standard offset from UTC. Two zones with the same offset but different daylight saving rules can still differ for part of the year.
- Directory roles that are only eligible through Privileged Identity Management (PIM) are listed once they're activated.
- Only site owners can list who has access to the site. For everyone else, that row shows Permission required, as expected, and their own effective permissions are still shown.
Examples
Service desk triage
Link to the diagnostics page from your ticket form, and ask people to paste their support summary into each new ticket, so agents start with the facts.
SharePoint in the wrong language
Find out why SharePoint appears in French for one person when the site is in English: the language comparison shows which setting differs and how to change it.
Dates and times that look wrong
Compare the device, SharePoint profile, site and mailbox time zones when meeting times or list dates look off for someone.
Access and licensing questions
Check someone's groups, site permission level and licenses when they can't open a site or don't see an app their colleagues use.
Best practices
- Add the web part to a help or support page that everyone can open, and link to it from your service desk.
- Approve the Microsoft Graph permissions before people use enhanced diagnostics, then check the results yourself.
- Keep sensitive values hidden by default, and ask people to share the support summary rather than full screenshots.
- Tell people what the page shows, and who will see the results they share.
- Turn on the public IP lookup only with an endpoint your organization approves, and let people know about it.
- Pair it with CNX Support, or set a support or help URL, so people can reach your team right from their results.
Release notes
AI features
November 2026
- AI assistance: explain the results, answer questions about them and draft a support request, from a masked digest.
Initial release
October 2026
- First release, included in CanoeUX SharePoint Web Parts Essentials.
Support
Have a question about CNX User Diagnostics, or found something that doesn't work as expected? Contact CanoeUX and tell us what you expected to happen and what happened instead. Screenshots help, and for display or access issues, so does the output of CNX User Diagnostics.
Planning a wider intranet? Explore our SharePoint and digital workplace services.
Free of charge
Support CanoeUX
CanoeUX SharePoint Web Parts Essentials is provided free of charge.
If these web parts helped you save time or deliver value to your organization, consider supporting future development.