Fix Mac Remote Desktop Client Cannot Find Workspace by UPN
Question details
The user is unable to subscribe to a corporate workspace using the macOS Remote Desktop client via their UPN, despite the Windows client and web client RDP files functioning properly.

- Product
- Microsoft Remote Desktop for Mac
- Device & OS
- macOS
- Scenario
- Subscribing to a corporate workspace feed using an email address (UPN) on a Mac device.
- Observed behavior
- The macOS client reports that no workspace is associated with the provided email address and fails to reach authentication, while the same UPN works on Windows and via downloaded RDP files.
Ensure you have the exact User Principal Name (UPN) provided by your IT department and verify that your Mac is connected to a stable network with access to corporate resources.
Verify Administrator Configuration and Refresh the Subscription
Ensure the macOS client is supported by your organization's configuration and reinstall the latest stable release to reset your workspace subscription.
In many cases, the workspace feed configuration may not properly expose macOS clients to the UPN mapping, even if Windows clients work flawlessly. Refreshing the client and verifying backend settings are essential first steps.
Ask your system administrator to confirm that the macOS client is explicitly supported for your organization's Remote Desktop service and that the workspace feed is configured for your user UPN.
Download and install the latest current production release of the Microsoft Remote Desktop client for Mac directly from the Mac App Store.
Open the Remote Desktop client, navigate to the Workspaces tab, right-click and remove any failed subscription attempts, then click 'Add Workspace' to try subscribing again with your exact sign-in address.

Use the Web Client as an Alternative Workaround
If the macOS application cannot discover the subscription, bypass the workspace discovery by downloading the RDP file manually via the web client.
Boost Your Mac Productivity with WPS Office
While troubleshooting your Mac remote desktop connections, ensure your local productivity remains uninterrupted. WPS Office is a highly compatible, lightweight, and completely free Office suite tailored for macOS users.
- 1. Visit the WPS Website: Go to the official WPS website on your Mac browser.
- 2. Download for Mac: Click the 'Free Download' button to get the macOS installation package.
- 3. Install and Work: Install the application and easily open, edit, or save your Microsoft Office documents locally without needing remote access.

Frequently Asked Questions
Why does my UPN work on Windows Remote Desktop but not on Mac?
This often occurs if the corporate workspace feed isn't explicitly configured by the administrator to support macOS client discovery, or if the Mac client has cached outdated or incorrect routing data.
Can firewall settings block the Mac Remote Desktop client from finding a workspace?
While theoretically possible, if you can successfully connect by double-clicking a downloaded RDP file on the same Mac, your local firewall and network settings are not the cause of the workspace discovery failure.
How do I completely clear cached settings in the Mac Remote Desktop client?
You can reset the client by uninstalling the app, navigating to your hidden Library folder, deleting the associated container files located at `~/Library/Containers/com.microsoft.rdc.macos`, and then reinstalling the app from the Mac App Store.




