How to restore the Legacy Viewport in Maya

Autodesk Support

May 17, 2024


Products and versions covered


Issue:

The Legacy Viewport is missing from Maya; it is not listed as an option in the viewport renderers.

Causes:

By default, the Legacy Viewport is not available in Maya, starting in 2018 and following versions.

Solution:

Activate the Legacy Viewport by adding the following text to the Maya.env file for Maya:​


Maya 2024 and newer versions

For more information and viewport setting, refer to OpenGL, DirectX 11, and OpenGL Core Profile.

 

Instruction for Windows:

  1. Go to C:\Users\YourUserName\Documents\maya\VersionFolder (2025, for example).
image.png
  1. Open the Maya.env file in Notepad (by default, it is empty).
  2. Paste the following text into the document: 
    • MAYA_ENABLE_DEPRECATED_VIEWPORT=1
  3. Resave the document.
  4. Relaunch Maya. The option to use Legacy Renderer in the Viewport is available, and have access to the Performance Settings window.

Instruction for Mac:

  1. Navigate /Users/YourUserName/Library/Preferences/Autodesk/maya/VersionFolder (2025, for example).
  2. Open the Maya.env file in a text editing program (by default, it is empty).
  3. Paste the following text into the document: 
    • MAYA_ENABLE_DEPRECATED_VIEWPORT=1
  4. Save and close the document.
  5. Relaunch Maya. The option to use Legacy Renderer in the Viewport is available, and have access to the Performance Settings window.
An error may appear when attempting to switch to legacy viewports in the workspace on both Mac and Windows. To avoid the error, navigate to Settings/Preferences, Preferences, Display, and change the rendering engine to legacy.

Note: Maya must be restarted for this change to apply.

rendering engine
Image: To view larger, right click the image and select 'open in new tab'

After adding the Environment Variable, launch Maya and activate the Legacy Viewport by selecting Legacy Default Viewport from the Renderer menu (menu available in all viewports):
 

legacy render engine
Note: Activating the Legacy Viewport restores the View Cube.



Maya 2023 and older versions


Instructions for Windows:

  1. Go to C:\Users\YourUserName\Documents\maya\VersionFolder (2023, for example).
image.png
  1. Open the Maya.env file in Notepad (by default, it is empty).
  2. Paste the following text into the document: 
    • MAYA_ENABLE_LEGACY_VIEWPORT=1
  3. Save and close the document.
  4. Relaunch Maya. The option to use Legacy Renderer in the Viewport is available, and have access to the Performance Settings window.

Instructions for Mac:

  1. Navigate /Users/YourUserName/Library/Preferences/Autodesk/maya/VersionFolder (2023, for example).
  2. Open the Maya.env file in a text editing program (by default, it is empty).
  3. Paste the following text into the document: 
    • MAYA_ENABLE_LEGACY_VIEWPORT=1
  4. Resave the document.
  5. Relaunch Maya. The option to use Legacy Renderer in the Viewport is available, and have access to the Performance Settings window.
An error may appear when attempting to switch to legacy viewports in the workspace on both Mac and Windows. To avoid the error, navigate to Settings/Preferences, Preferences, Display, and change the rendering engine to legacy.

Note: Maya must be restarted for this change to apply.

rendering engine
Image: To view larger, right click the image and select 'open in new tab'

After adding the Environment Variable, launch Maya and activate the Legacy Viewport by selecting Legacy Default Viewport from the Renderer menu (menu available in all viewports):
 

legacy render engine
Note: Activating the Legacy Viewport restores the View Cube.

Products:

Maya;


Was this information helpful?


Need help? Ask the Autodesk Assistant!

The Assistant can help you find answers or contact an agent.


What level of support do you have?

Different subscription plans provide distinct categories of support. Find out the level of support for your plan.

View levels of support