VMware ESXi and vSphere Cluster Management

Enable and Use Unity Mode in VMware Workstation Player

Learn how to enable Unity Mode in VMware Workstation Player, launch guest applications on the host desktop, manage file limitations, troubleshoot problems, and exit Unity Mode.

What Unity Mode does

Unity Mode is a VMware display mode that shows supported applications from a guest operating system as individual windows on the host operating system desktop. The host operating system runs on the physical computer. The guest operating system runs inside a virtual machine managed by VMware Workstation Player.

When Unity Mode is active, the traditional virtual machine window and full guest desktop are hidden or minimized. A guest application can appear beside native host applications, and supported guest applications may be represented on the host taskbar or application switcher.

Prerequisites before enabling Unity Mode

Check these conditions before trying to switch display modes:

• The virtual machine is powered on and has fully booted into a supported graphical desktop guest operating system.
• VMware Tools is installed, running, and compatible with the guest operating system. VMware Tools provides guest-side integration components, including display and Unity support.
• The guest display environment supports Unity integration. A text-only session or an unsupported desktop environment cannot provide the expected Unity experience.
• You can access VMware Workstation Player menus, and the Player window is focused.
• The virtual machine is not powered off, suspended, still booting, or otherwise in a state that prevents display-mode changes.

Basic familiarity with starting a virtual machine, focusing its window, using Player menus, and managing applications and files in the guest will make the procedure easier.

Enable Unity Mode

1. Start the supported guest virtual machine if it is not already running.
2. Wait until the guest graphical desktop and its normal application launcher are fully available.
3. Open or focus the running virtual machine in VMware Workstation Player.
4. From the Player menu, select Unity.

Player > Unity

After activation, the regular Player and guest desktop view is hidden or minimized. Supported guest applications become available through the integrated desktop experience. The exact transition can vary by Workstation Player version, host platform, guest operating system, and VMware Tools version.

Open and use guest applications in Unity Mode

Unity Mode provides access to the guest operating system's Start menu or application launcher where the guest environment supports it. The menu still belongs to the guest; it is only being exposed through the Unity interface.

1. Open the guest Start menu or application launcher from the Unity interface.
2. Choose a guest application. For a simple test, launch WordPad or another built-in text editor available in the guest.
3. Observe that the application opens as a separate window on the host desktop.
4. Move, resize, minimize, or close the window using the host desktop's normal window controls where supported.

The WordPad window may look like an ordinary host application window, but it remains a guest application. Its processes, settings, installed components, and data are controlled by the guest operating system.

Example: identify the application correctly

Open a native host editor and the WordPad window launched from the guest Start menu. They may appear next to one another on the host desktop. The native editor uses host resources and host paths, while WordPad uses the guest environment and guest filesystem. Their similar appearance does not make them the same type of application.

File access and storage limitations

Unity Mode is a display and interaction feature, not a shared filesystem. Enabling it does not automatically allow a host file to be opened directly in a guest application.

• A guest application's ordinary file picker normally shows guest filesystem paths.
• Saving a document from a Unity-mode guest application normally writes to the guest filesystem, not directly to a host folder.
• Host folders are not automatically available just because a guest window is displayed on the host desktop.
• To move a document between systems, configure a separate method such as VMware shared folders, drag-and-drop, copy-and-paste, a network share, or removable media, as appropriate.

Shared folders are a separate VMware feature that exposes selected host folders to the guest. They should not be confused with Unity Mode.

Example: save a document and transfer it

1. Launch WordPad or another guest editor through Unity Mode.
2. Create or edit a document and choose Save As.
3. Inspect the locations offered by the guest application's file dialog. These locations are normally in the guest filesystem.
4. Save the document to a guest folder.
5. If the document must reach the host, copy or move it through a separately configured shared folder, network location, removable device, or another approved exchange method.

If the file cannot be found on the host afterward, first look for it in the guest filesystem. Unity Mode alone does not change the save destination.

Unity Mode behavior and limitations

Exit Unity Mode

1. Reveal the VMware Workstation Player window or controls if they are hidden behind other windows.
2. Use the Exit Unity control.
3. Confirm that the normal virtual machine window and the full guest desktop are visible again.

Exiting Unity Mode does not shut down the guest. Guest applications return to their standard context within the Player window. Save important guest work before closing applications or restarting the virtual machine.

Troubleshooting Unity Mode

The Unity option cannot be selected

Common causes include a powered-off, suspended, still-booting, or unfocused virtual machine; missing or stopped VMware Tools; an outdated or incorrect Tools installation; or an unsupported guest operating system or graphical desktop.

1. Start the virtual machine and wait for the graphical guest desktop to finish loading.
2. Bring VMware Workstation Player to the foreground.
3. Verify that VMware Tools is installed and running in the guest. Install, repair, update, or restart it when necessary.
4. Confirm that the specific Workstation Player release, host platform, guest operating system, and desktop environment support Unity Mode.

The Unity entry is absent

An absent menu entry commonly indicates that the current Player version, host platform, guest operating system, guest desktop, or VMware Tools version does not provide Unity support. It can also occur when the virtual machine is not in a suitable running state. Verify the same prerequisites before treating the missing entry as a menu problem.

Unity starts, but guest applications or the guest menu are not visible

The guest session may still be loading, the guest shell or launcher may not be functioning, or the desktop environment may have limited Unity compatibility.

• Wait for the guest desktop session to finish starting and try again.
• Restart the guest session or virtual machine if appropriate.
• Verify VMware Tools status and test with a supported guest desktop environment.

The guest desktop remains visible

Unity may not have completed its transition, or the guest integration components may not be operating correctly. Confirm that VMware Tools is running, retry the Unity command after the guest has finished booting, and check compatibility for the installed guest desktop.

A host document cannot be opened from a Unity-mode guest application

This is expected when no host-guest file path has been configured. Unity Mode is being mistaken for a shared filesystem feature. Place the document in the guest through shared folders, a network share, copy-and-paste, drag-and-drop, removable media, or another supported method, then open it from a guest path.

A document saved from Unity Mode cannot be found on the host

The document was probably saved inside the guest filesystem. Locate it in the guest first, then transfer it using a configured shared folder, network location, removable device, or another appropriate exchange method.

You cannot return to the normal virtual machine display

Bring VMware Workstation Player to the foreground and use Exit Unity. If the interface is unresponsive, close guest applications where possible and consider unsaved guest work before restarting the virtual machine.

Operational caveats

Exact menu names, Unity availability, window behavior, taskbar representation, and launcher access can differ between Workstation Player versions, host platforms, guest operating systems, desktop environments, and VMware Tools versions. A disabled or missing Unity control usually points to a compatibility issue, a guest desktop issue, a VMware Tools problem, or an unsuitable virtual machine power state.

For reliable results, fully boot the guest, verify VMware Tools, use a supported graphical desktop, and keep file transfer configuration separate from display-mode configuration.