Self-help diagnostics for Microsoft Teams administrators
As Microsoft Teams usage grows, Microsoft has developed Teams-specific diagnostic scenarios that cover top support topics and the most common tasks for which administrators request configuration help. It is important to note that while these diagnostics cannot make changes to your tenant, they do provide insight into known issues and the instructions that you’ll need to fix the issues quickly.
This feature isn't available for Microsoft 365 Government, Microsoft 365 operated by 21Vianet, or Microsoft 365 Germany.
While you’re logged in as an administrator, visit your Microsoft 365 admin center. In the navigation pane, select Show all > Support > New service request. After you briefly describe your issue (for example, “I can't invite a guest to Teams”), the system determines whether a diagnostic scenario matches your issue.
As you type search terms, a type-ahead query assists you to find the topics that you’re searching for.
Enter your organization’s root URL. In the Guest Access diagnostic, select the drop-down arrow, select a pre-populated URL from your tenant, and then select Run tests.
After the diagnostic checks finish and the configuration issue is found, the system provides the steps to resolve the issue. In this example, the Tenant Admin had not turned on Guest Access:
If a diagnostic detects an issue, and you've implemented a fix based on the results, consider rerunning the diagnostic to ensure the issue is completely resolved.
When IT admins run customer diagnostics in the Microsoft 365 admin center to resolve issues without logging support requests, Microsoft will make donations to global nonprofit organizations.
For more information, see Diagnostics for Social Good.
What scenarios are currently covered?
You must be an M365 Administrator to run diagnostics.
The following diagnostics are currently available with brief scenario descriptions and shortcut commands:
|Category||Diagnostic||Description||Shortcut Link||Support Article|
|Authentication||Teams Sign-in||Validates that a user can sign in to the Teams app.||Run Tests: Teams Sign-In||Resolve sign-in errors in Teams|
|Authentication||Teams Federation||Validates that the Teams user can communicate with a federated Teams user.||Run Tests: Teams Federation||Manage external access (federation)|
|Authentication||Unable to Invite Guest Users to Teams||Validates that a specific guest can sign into Teams.||Run Tests: Teams Guest Access||Guest access in Microsoft Teams|
|Files||Teams Files Guest Access||Validates that guest users can be added to Teams and the Team is shared with the user.||Run Tests: Teams Files Guest Access||Guests can't access Files tab for shared files in Teams|
|Files||Unable to upload files to Teams chat||Validates if the specified user can upload files in Teams chat.||Run Tests: Unable to upload files to Teams chat||Error when uploading files to a Teams chat|
|Files||Unable to access files shared in Teams chat||Validated that a specified user being unable to access files shared by another user in chats.||Run Tests: Unable to access files shared in Teams chat||Error (You don't have access to this file) when opening a file in Teams|
|Files||Unable to access files in a team||Validates that a specified user has access to files in the Team.||Run Tests: Unable to access files in a team||Can't access the Files tab on a Teams channel|
|Files||We Can't Get Your Files||Validates that a Team is provisioned and accessible by the specified user.||Run Tests: Teams Files Error|
|Meetings||Teams Calendar App||Validates that the pre-requisites are properly configured for the Microsoft Teams calendar app to function.||Run Tests: Teams Calendar App|
|Meetings||Meeting Recording Missing||Attempts to locate a missing Teams Meeting Recording||Run Tests: Missing Recording||Teams cloud meeting recording|
|Meetings||1:1 Call Recording||Checks a user's policy for 1:1 Call Recording capability||Run Tests: Teams 1:1 Call Recording|
|Meetings||Teams Add-in is Missing in Outlook||Validates that a user has the correct policies to enable the Teams Outlook add-in.||Run Tests: Teams Add-in Missing in Outlook|
|Meetings||Teams Live Events||Validates that a user is able to schedule Teams live events.||Run Tests: Teams Live Events|
|Meetings||Teams Meeting Recordings||Validates that the user is properly configured to record a meeting in Teams.||Run Tests: Meeting Recording||Teams cloud meeting recording|
|Presence||Teams presence||Validates that a user's Teams presence can be correctly displayed.||Run Tests: Teams presence||Your actual presence status isn't displayed in Teams|
|Voice||Teams Direct Routing||Validates that a user is correctly configured for direct routing.||Run Tests: Teams Direct Routing||Monitor and troubleshoot Direct Routing|
|Voice||Teams Call Queue||Validates that a call queue is able to receive calls.||Run Tests: Teams Call Queue||Create a call queue in Microsoft Teams|
|Voice||Teams Dial Pad is Missing||Validates that the dial pad is visible within Teams.||Run Tests: Teams Dial Pad Missing||Dial pad in missing in Teams|
|Voice||Unable to Make Domestic or International PSTN calls in Teams||Validates that a user has the ability to make or receive domestic or international PSTN calls.||Run Tests: Teams PSTN|
|Voice||Unable to Join or Create a Teams Conference Call||Validates that a user has the ability to create or join a PSTN conference call.||Run Tests: Teams Conference|
|Voice||Teams Auto-Attendant||Validates that an auto attendant is able to receive calls.||Run Tests: Teams Auto Attendant||Set up an auto attendant for Microsoft Teams|
|Voice||Teams Voicemail||Validates that a user is properly configured to use Voicemail in Teams.||Run Tests: Voicemail|
|Voice||Teams Call Forwarding||Validates that a user is properly configured to forward calls to a specified number.||Run Tests: Teams Call Forwarding|
More diagnostics will be added at a future date.
Still need help? Go to Microsoft Community.