Search the VMware Knowledge Base (KB)
View by Article ID

Editing the .vmx file of a VMware Workstation and VMware Player virtual machine (2057902)

  • 16 Ratings


This article provides steps to edit the .vmx (virtual machine configuration) file of your VMware Workstation and VMware Player virtual machine.
Note: Editing a .vmx file may be required to complete steps in a Knowledge Base article or at the request of VMware Support staff.


Caution: Before you alter the virtual machine's files, VMware recommends copying the virtual machine's folder to a safe location (either on an external hard drive or anywhere else on the PC's hard drive) to backup the virtual machine. For more information, see Best practices when backing up a VMware Workstation virtual machine (2006202).

To edit the .vmx file:
  1. Shut down the virtual machine.
  2. Locate the virtual machine's files. For more information, see  Locating a hosted virtual machine's files (1003880).
  3. Open the virtual machine's configuration file (.vmx) in a text editor.
  4. Add or edit lines as needed. Lines are displayed in no particular order.
  5. When finished, save the changes by using the save option in the text editor.
  6. Exit the text editor.


  • Changes made to the .vmx file do not take effect until the next time VMware Workstation or VMware Player is opened. If the application is currently open, quit it and re-open for the changes to take effect. Alternatively, double-click the .vmx file to apply the changes and open the virtual machine immediately.
  • Windows Operating systems hide file extensions by default. We recommend you enable file extensions to ensure the file that is being edited is proper. For more details, see Microsoft article Show or hide file name extensions

Additional Information

The .vmx file contains settings for your virtual machine's behavior. Some of these settings are accessible through the VM > Settings menu option, but some settings can be changed only in the file.

See Also

Update History

02/12/2014 - Updated for Workstation 11.x 02/12/2014 - Updated for Player 7.x

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.


  • 16 Ratings

Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.

What can we do to improve this information? (4000 or fewer characters)

Please enter the Captcha code before clicking Submit.
  • 16 Ratings