VMware ESXi and vSphere Cluster Management
Copy and Paste Between Host and Guest in VMware Player
Learn how VMware Player clipboard integration transfers text, images, attachments, and supported files between a host and guest, including prerequisites, limits, workflows, and troubleshooting.
VMware Player can share clipboard content between the host system and a guest operating system. The host is the physical computer and its operating system. The guest is the operating system running inside a VMware virtual machine (VM).
This integration lets you copy, cut, and paste supported content between host and guest applications. It can transfer text, images, email attachments, and supported files. Direct file copy and paste between two guest virtual machines is not supported by this feature, although text clipboard sharing between VMs may work when the environment supports it.
How Clipboard Integration Works
Clipboard integration is the ability to transfer content placed on a clipboard from one environment to another. The source environment is where you select and copy or cut content. The destination environment is where you focus an application or desktop and paste that content.
- Host-to-guest: transfer content from the physical computer into a virtual machine.
- Guest-to-host: transfer content from a virtual machine to the physical computer.
- VM-to-VM text: transfer text between two virtual machines when supported by the host, guests, applications, and display sessions.
The destination application must accept the type of content being pasted. For example, text can usually be pasted into a text editor, while a file needs a suitable desktop or file manager destination.
Copy, Cut, and Paste
Copy places a duplicate of selected content on the clipboard while leaving the original in place. Cut places selected content on the clipboard while intending to remove it from its original location. Paste inserts clipboard content into the currently selected destination.
Use the normal operating-system keyboard shortcuts for these actions, or use the application menus. Exact key combinations vary between operating systems and applications, so the commands can also be selected from menus such as Edit or a file manager's context menu.
- Select content in the source host or guest application.
- Use the normal Copy or Cut command.
- Switch focus to the destination host or guest window.
- Select a suitable application, desktop location, or folder.
- Use the normal Paste command.
The action always begins in the source environment and ends in the destination environment. If the destination does not support the content type, paste may be unavailable or may appear to do nothing.
Prerequisites and Compatibility
VMware Tools must be installed in each guest virtual machine that needs clipboard integration. VMware Tools is guest-side VMware software that provides integration capabilities, including copy and paste support. An incomplete, outdated, or malfunctioning installation can prevent transfers from working.
The VM must be powered on, and the guest's graphical desktop session must be active. For Linux hosts and Linux guests, the stated clipboard support requires an active X Window System graphical session. The X Window System is a graphical display environment used by Linux desktop sessions.
| Requirement | Why it matters | How to verify |
|---|---|---|
| VMware Tools installed | Provides guest-side integration services. | Verify that VMware Tools is installed and functioning in the guest. |
| Guest operating system running | Clipboard integration requires an active VM. | Start the VM and confirm that the guest desktop is accessible. |
| Graphical desktop session active | Copy and paste operates through desktop applications and windows. | Log in to the guest desktop rather than using only a text console. |
| X Window System for Linux hosts and guests | The stated Linux clipboard support depends on an X-based graphical session. | Confirm that the Linux system is using an active X Window System session. |
| Content within applicable size limits | Oversized clipboard content may fail. | Keep copied text and email attachments below 4 MB. |
| Destination supports the content | Applications decide which clipboard formats they can accept. | Try a compatible editor, file manager, desktop, or other destination. |
Compatibility also depends on the particular host operating system, guest operating system, application, and display-session combination. A working text transfer does not guarantee that every image, attachment, or file format will transfer.
Supported Content and Limits
Copied text and email attachments must each be less than 4 MB. Content at or above the limit may not paste successfully. Unsupported formats, incompatible applications, and destinations without write access can also cause a transfer to fail.
| Transfer direction | Content type | Supported status | Limit or requirement | Recommended alternative if unsupported |
|---|---|---|---|---|
| Host to guest | Text | Supported | Text must be less than 4 MB; VMware Tools and a compatible graphical session are required. | Use a shared folder or another transfer method for larger content. |
| Guest to host | Text | Supported | Text must be less than 4 MB; the destination application must accept the text. | Use a shared folder or another transfer method for larger content. |
| VM to VM | Text | May be supported | Depends on the host, guests, applications, and display sessions. | Use an intermediary application or shared method if clipboard sharing fails. |
| Host to guest | Files | Supported for supported file types | Paste into the guest desktop or a compatible guest application; destination permissions apply. | Use drag-and-drop or shared folders. |
| Guest to host | Files | Supported for supported file types | Paste into an available host folder or compatible host application; destination permissions apply. | Use drag-and-drop or shared folders. |
| VM to VM | Files | Not supported by direct copy and paste | Files cannot be copied and pasted directly from one VM to another VM. | Transfer through the host, a shared folder, or another intermediary. |
| Host and guest | Email attachments | Supported when applications accept the format | Attachment must be less than 4 MB. | Use a shared folder or another file-transfer method for larger attachments. |
| Host and guest | Images | Supported when applications accept the image format | Source and destination applications must support the image content. | Save the image first, then use a shared folder or drag-and-drop. |
Host-to-Guest File Copy
The guest desktop is a simple destination for demonstrating a host-to-guest file transfer.
- On the host desktop or in a host file manager, select a supported file.
- Use the normal Copy command.
- Switch focus to the running guest virtual machine.
- Select the guest desktop or open a guest folder or compatible application.
- Use the normal Paste command.
- Check the selected guest destination and confirm that the file appears.
If the file appears on the guest desktop or in the selected guest folder, the transfer succeeded. If nothing appears, verify that the guest window had focus and that the destination permits writing.
Example: Copy a File to the Guest Desktop
- Select a small, supported file on the host desktop.
- Copy it using the operating system's standard Copy command.
- Click the guest desktop so the VM has focus.
- Paste using the standard Paste command.
- Confirm that the file icon is visible on the guest desktop.
Guest-to-Host Transfer
The reverse workflow transfers supported content from a VM to the physical host.
- In the guest, select text, an image, attachment, or supported file.
- Use the guest's normal Copy or Cut command.
- Focus the host desktop, host file manager, or compatible host application.
- Choose a suitable destination folder or application.
- Use the host's normal Paste command.
- Check that the content appears and that the host destination is available and writable.
For files, choose a destination where the host user has permission to create or modify items. A paste can fail even when clipboard integration is working if the destination folder is read-only, unavailable, or blocked by permissions.
Example: Test with Plain Text
- Select a short text sample in a host application.
- Copy the sample to the host clipboard.
- Focus a text-capable application in the guest.
- Paste the text and verify that it appears.
A small plain-text test is a low-risk way to determine whether the integration works before testing a file, image, or email attachment.
Example: Transfer a Small Email Attachment
- Identify an email attachment smaller than 4 MB.
- Copy it from the source email application.
- Focus a compatible destination application or desktop in the other environment.
- Paste the attachment.
- Verify that the transferred item is available at the destination.
Virtual Machine-to-Virtual Machine Behavior
Clipboard operations may transfer text between two VMs when the environment supports that operation. This is text clipboard sharing, not general file exchange.
Direct copy and paste of files from one virtual machine to another virtual machine is not supported by this feature. To move a file between guests, use the host as an intermediary, a shared folder, drag-and-drop where available, or another suitable file-transfer method.
Example: Attempting VM-to-VM File Transfer
- Recognize that direct VM-to-VM file copy and paste is unsupported.
- Use VM-to-VM clipboard sharing only for text when the environment supports it.
- For files, transfer through the host or use a shared folder or other intermediary.
Troubleshooting Clipboard Problems
Paste Does Nothing Between Host and Guest
- Verify that VMware Tools is installed and functioning in the guest.
- If VMware Tools was installed or updated recently, restart the guest.
- Confirm that the guest graphical desktop session is active.
- Check that the intended host or guest window has focus before pasting.
- Try a small plain-text sample in a basic text application.
Copy and Paste Fails on Linux
- Verify that the Linux host and guest use an active X Window System graphical session.
- Retry the operation from graphical applications within that session.
- Check that the operation is not being attempted from an incompatible text-only console.
Large Text or an Email Attachment Will Not Paste
- Check whether the text or attachment is less than 4 MB.
- Reduce the content size if possible.
- Use a shared folder or another file-transfer method for larger content.
A File Cannot Be Copied Directly Between Two VMs
- Confirm that the attempted direction is guest-to-guest file transfer.
- Remember that direct VM-to-VM file copy and paste is not supported.
- Use the host, a shared folder, drag-and-drop where available, or another intermediary.
Text Works but an Image or File Does Not
- Check whether the source and destination applications support the content type.
- Try a different compatible application or the destination desktop.
- Check whether the file format is supported in the current host and guest combination.
- Verify that the destination folder is writable and available.
- Try drag-and-drop or a shared folder when appropriate.
Alternative Transfer Methods
Drag-and-drop is a related convenience feature that may be available for moving content between the host and guest. It can be useful when supported clipboard formats do not paste as expected.
Shared folders provide a persistent exchange location that both host and guest can access. They are preferable for repeated transfers, larger files, or workflows that need a stable folder rather than a one-time clipboard operation.
- Use drag-and-drop when it is available and convenient for a one-time transfer.
- Use shared folders for repeated exchanges or larger files.
- Use an intermediary such as the host when transferring files between two VMs.
- Use alternatives when clipboard operations fail because of content type, size, permissions, or compatibility.
Exam-Relevant Notes
- VMware Tools is required in the guest for clipboard integration.
- Host-to-guest and guest-to-host are supported transfer directions for supported content.
- Text and email attachments must be less than 4 MB.
- Linux host and guest clipboard support requires an X Window System graphical session.
- Direct file copy and paste between two VMs is not supported, although text sharing may work between VMs.
- The destination application must support the pasted content type, and the destination must be writable for file transfers.