Copy and Paste Between Host and Guest in VMware Player
Learn how to copy text, images, files, and email attachments between a host and VMware Player guest, including requirements, limits, alternatives, and troubleshooting.
VMware Player can integrate the clipboard of the host system with the clipboard of a guest operating system. The host is the physical computer and operating system running VMware Player. The guest is the operating system running inside the virtual machine (VM).
With clipboard integration available, you can copy content from the host to the guest or from the guest to the host. You continue to use the normal operating-system or application commands: Cut, Copy, and Paste. No special VMware Player command sequence is required.
How Host and Guest Clipboard Integration Works
Copy places selected content on the clipboard while leaving the original in place. Cut removes selected content and places it on the clipboard. Paste inserts clipboard content into a destination application or folder.
- Host to guest: copy content in a host application or file manager, focus the guest application or folder, and paste.
- Guest to host: copy content in a guest application or file manager, focus the host destination, and paste.
Keyboard shortcuts such as Ctrl+C and Ctrl+V, or the equivalent shortcuts on the operating systems involved, work when clipboard integration is functioning. Application menus and context menus can also provide Copy and Paste commands.
Requirements
- VMware Tools must be installed and running in the guest. VMware Tools is guest-side integration software that enables clipboard sharing and other enhanced desktop interactions.
- The guest must provide a responsive graphical desktop session. Clipboard integration is not a general-purpose terminal-only transfer mechanism.
- For the described Linux host and Linux guest scenario, both systems must use an X Window System graphical environment where applicable. X Window System, also called X-Windows, is a graphical windowing environment.
- The virtual machine must be powered on, and the guest operating system must be responsive.
VMware Tools installation procedures vary by guest operating system and VMware Player version. Use the procedure appropriate for the guest rather than assuming one universal installation command. See VMware Tools Overview, Install VMware Tools in Linux, or Install VMware Tools in Windows.
Supported Transfer Scenarios
Clipboard integration can transfer several kinds of content between a host and one guest. Success depends on VMware Tools, the guest desktop environment, the source application, the destination application, and the clipboard format they support.
| Transfer type | Supported direction | Requirements | Limitations |
|---|---|---|---|
| Text | Host to guest and guest to host | VMware Tools, a graphical session, and applications that accept the text format | Text must be less than 4 MB |
| Images | Host to guest and guest to host | Both applications must support a compatible image clipboard format | The receiving application may reject the image or its format |
| Files | Host to guest and guest to host | A host or guest file manager or application must support the operation | Large files and unsupported workflows may not transfer; guest-to-guest direct copy is not supported |
| Email attachments | Host to guest and guest to host | The participating email applications must support the attachment clipboard operation | Attachments must be less than 4 MB |
| Files directly between two virtual machines | Not supported directly | Use an intermediary location accessible to both guests | Clipboard integration is intended for host-to-guest and guest-to-host transfers |
Content Size Limits
Text copied through this feature must be less than 4 MB. Email attachments copied through the feature must also be less than 4 MB. Content at or above that limit may fail to paste or may produce an incomplete result.
The limit does not make clipboard integration a suitable general-purpose large-file transfer system. For larger items, use shared folders, a network share, secure copy, removable media, or another transfer method supported by the guest.
Copy a File from the Host to the Guest
- Open the host location containing the file, such as the host desktop or file manager.
- Select the file.
- Use the host's standard Copy command, keyboard shortcut, or context-menu command.
- Switch focus to the running virtual machine.
- Open the intended guest destination, such as the guest desktop or a guest file manager.
- Use the guest's standard Paste command or keyboard shortcut.
- Verify that the copied file appears in the guest destination.
For example, select a file on the host desktop, press Ctrl+C, click the guest desktop, and press Ctrl+V. The expected result is a copy of the host file on the guest desktop.
Transfer Text Between Applications
- Select a small block of text in the source application.
- Use the normal Copy command.
- Focus a text field or document in the application on the other side of the host/guest boundary.
- Use Paste.
- Check that the text appears correctly.
Testing with a small plain-text selection is useful because it verifies basic clipboard integration without introducing file-size or data-format issues.
Transfer Images Between Applications
- Select or copy an image in the source application.
- Switch focus to an image-capable application on the other system.
- Use Paste.
- Verify that the image appears in the destination.
The receiving application must accept the copied image format. An image may work between two image editors but fail when pasted into a text-only field or an application that does not support that format.
For example, copy an image in a guest graphics application, switch to an image-capable host application, and paste. The host application receives the image only if the applications support a common clipboard format.
Important Limitations
- Files cannot be copied and pasted directly from one virtual machine to another virtual machine.
- The feature is designed for transfers between the host and a guest, not direct guest-to-guest file transfer.
- Text and email attachments must be less than 4 MB.
- Large files may not transfer successfully through this workflow.
- The source and destination applications must support the relevant clipboard data type.
- Copy and paste is separate from drag-and-drop and shared-folder functionality.
Choosing an Alternative Transfer Method
Use another method when clipboard integration is unavailable, the item is too large, or the destination application does not accept the data type.
- Drag-and-drop: useful for occasional host-to-guest file transfers when the workflow is available and appropriate. It is separate from clipboard copy and paste.
- Shared folders: useful for repeated access, larger files, or a host directory that the guest needs to use regularly.
- Network shares: useful when the host and guest can communicate over a configured virtual network.
- Secure copy or another network transfer: appropriate for systems that provide the required network services.
- Removable media: useful when a file must be moved without relying on clipboard integration.
To transfer a file between two VMs, place it in a host-accessible shared location, network share, or other intermediary location accessible to both guests. Do not attempt to paste the file directly from one VM window into another.
Copy and Paste Limitations and Alternatives
| Situation | Copy/paste status | Reason or limit | Recommended alternative |
|---|---|---|---|
| VMware Tools missing or not running | Unavailable or unreliable | Guest-side clipboard integration is not active | Install or repair VMware Tools |
| Linux without an X-Windows graphical session | Unavailable for the described scenario | The required graphical environment is not in use | Use an X Window System desktop session or a network/file-transfer method |
| Text at or above 4 MB | Not supported by the stated limit | Text must be less than 4 MB | Reduce the content or transfer it as a file |
| Email attachment at or above 4 MB | Not supported by the stated limit | Attachments must be less than 4 MB | Use a shared folder or another file-transfer method |
| File transfer directly from one VM to another | Not supported directly | The feature does not provide guest-to-guest file copy | Use a host-shared folder, network share, or intermediary location |
| Unsupported destination application or content type | May fail | The applications do not support a common clipboard format | Try a compatible application or use drag-and-drop or file transfer |
Troubleshooting Clipboard Integration
Paste Is Unavailable or Nothing Transfers
Check the following in order:
- Confirm that the VM is powered on and the guest desktop is responsive.
- Check whether VMware Tools is installed and running in the guest. Install or repair it if necessary.
- Confirm that the guest is using a supported graphical desktop session.
- If Linux is involved, confirm that the relevant host and guest sessions use X-Windows where applicable.
- Retry with a small plain-text selection.
- Restart the guest desktop session or virtual machine if the integration service appears stuck.
Linux Clipboard Transfer Does Not Work
The described Linux host-and-guest scenario requires an X Window System graphical environment. A terminal-only session does not provide the required desktop clipboard workflow. Use an X-Windows desktop session, or use shared folders or a network-based transfer method when no graphical session is available.
A Large Text Block or Email Attachment Fails
Check whether the text or attachment is at or above 4 MB. The applicable limit is less than 4 MB. Reduce the content where practical, or transfer it as a file through a shared folder, network share, secure copy, or another suitable method.
A File Cannot Be Pasted Between Two VMs
This is expected behavior: direct virtual-machine-to-virtual-machine file copy and paste is not supported. Transfer the file through the host, a shared folder, a network share, or another intermediate location accessible to both guests.
Text Works but an Image or File Does Not
This usually indicates an application or clipboard-format issue rather than a basic clipboard connection problem. Try an application that accepts the relevant image or file data type. If it still fails, use drag-and-drop, shared folders, or another file-transfer method.
Quick Verification Checklist
- The VM is powered on and responsive.
- VMware Tools is installed and running.
- The guest uses a graphical desktop session.
- Linux host and guest sessions use X-Windows where applicable.
- The source application placed the intended data on the clipboard.
- The destination application accepts that data type.
- Text or email attachments are less than 4 MB.
- A shared folder or another transfer method is used for larger files or guest-to-guest transfers.