In This Class You’ll Access…
This page is for Zoo Tools Pro known bugs/issues and work-arounds.

Please login to see this page.

Running Time: 0
Software: Zoo Tools Pro 2
Maya 2017-2020


Class Videos: None
Instant Access, Full Site Access $10/mnth. Cancel Anytime

On this page, you’ll find Zoo Tools Pro 2 known bugs, workarounds and fixes. Please check here before reporting bugs.

Please be sure to have the latest version of Zoo Tools Pro 2 and the latest Maya Update installed.

Latest Zoo Tools Pro 2:

Zoo Tools Pro 2 Latest Version: 2.4.1
To download older versions please go to the Changelog Page .

Please use Zoo Tools Pro with the latest Maya updates:

Maya 2017 Latest Update: 2017.6
Maya 2018 Latest Update: 2018.6
Maya 2019 Latest Update: 2019.3
Maya 2020 Latest Update: 2020.2

If you do not see the bug or issue mentioned here please report it to the Facebook Group or email us at .



Maya 2020
Maya 2017
Zoo Windows
Zoo Shelf
Joints And Controls



The majority of reported Zoo Tools bugs are not related to our tools, most of them are vanilla Maya bugs. Please read this section.

The Most Common Maya Issue – PLEASE READ
If you cannot find the issue on this page please reset your “userPrefs.mel” this is the cause of the majority of Maya issues. Maya is complex software and has many bugs of its own, often Zoo Tools Pro often gets the blame when it’s not the cause of most issues.

Your (insert random Maya bug) could be to do with the Maya prefs file, this file corrupts, and you can easily reset/fix it. userPrefs.mel corruption is the most common Maya issue even without Zoo Tools Pro installed.

1. Close Maya
2. Then delete the prefs file (Maya prefs path) maya\2019\prefs\userPrefs.mel
Windows: It’s found in your Documents or My Documents folder
OSX: /Users/yourUsername/Library/Preferences/Autodesk/maya*
*OSX Note: To open the hidden Preferences directory:
Select Finder > Go, press Alt and the Library folder appears in the menu.
3. Start Maya and see if the issue has been fixed.
4. Optionally you can manually reset the prefs file to our preferred defaults. To return to our settings, follow videos 1.3, 1.4 and 1.5 on the Zoo 1 merge install page here , these videos still apply to Zoo 2.

Resetting Maya’s Window Layout
For general UI issues you can also try resetting the UI Windows > Workspaces > Reset “Maya Classic” To Factory Default.

Maya Manipulator And Snap Issues
For manipulator and snap issues double click on the move tool icon in the left sidebar and hit reset, repeat for the select, scale and rotate icons. The UV editor can also get stuck in various snap modes, to fix open the UV Editor > Tools > Move (options) and reset the tool. Repeat for UV select, UV rotate and UV scale.

If Maya’s manipulator size gets too large or small it is set with the “-” and “= keys”.



CG Monks Conflict
We have a known issue with the CG Monks Toolbox . They have branched the old opensource version of Zoo Tools and include it in their imports clash with our tools. Zoo Tools Pro may not start with their tools installed. We recommend you disable their tools if you’d like to use Zoo Tools Pro v1 or v2.


Maya 2020

Docking Crash
There is a crash in Maya 2020 with docking Zoo 2 windows to the Attribute Editor or Outliner Sections. Docked windows appear empty and removing or closing the tab will crash Maya.

In Maya 2020 Please do not dock inside the Channel Box/Attribute Editor or Outline areas, you can dock beside these areas without issues.

We have started a major redesign of our UI code to fix this issue.

Theme Colors Don’t Update
Color Themes in the Zoo Preferences Window are fully working in Maya 2020, however the windows are not refreshing as you change the themes. Please save the theme and then reload Zoo Tools. ZooToolsPro (shelf) > Developer Tools Icon (purple) > Reload. You will see changes after the reload.


Maya 2017

Large Shelf Icons
In Maya 2017, the icons are too big, they still work but they are large and cut in half. This is due to a known Maya issue and is not due to Zoo Tools.

There are some Arnold issues regarding some compatibility with older versions of Arnold, though most Arnold related tools work fine. You can also upgrade Arnold to the latest version to fix these issues.


Zoo Windows – Fixed

Transparent & UI display Issues Graphics issues such as transparent UI windows are caused by upgrades from 2.2.3 and below.
Fix with…

Zoo Preferences Window > Theme Colors > Revert Theme To Default (the box icon next to rename)
Click Save then close and reopen any window.

If the issue persists, then follow the instructions in this video .

Zoo Windows Don’t Appear, No Errors
There is a bug where Zoo Windows don’t appear; first if you are on OSX and prior to 2.3.9 check the window is not behind Maya (fixed in 2.3.9).

If you still cannot find the windows and there are no errors it is most likely due to the Zoo Windows being on hidden monitors with dual monitors. We can reproduce this bug when the order of the monitors is reversed. So the second (number 2) monitor is on the left-hand side.

Try rotating the monitors back so the second virtual monitor thinks it is on the left, and re-open Zoo windows. Try placing all windows, any Toolset window, Zoo Preferences, and Zoo Hotkeys on the first primary monitor, then close Maya. You should be able to return to the flipped monitor setup.

We believe this monitor bug has been fixed in 2.2.3 and above, please report if you are still seeing this.


Zoo Shelf – Rare

Zoo Icons Appear Too Big – 2017-2018
2017 has a bug where the shelf icons will be too big. 2018 this is very rare and only affects certain machines. We should have fixed this in 2019 and 2020 2.1.0 (and above).

The oversized icon bug is related to a known Maya issue and we will not be fixing this one as Autodesk has fixed it in 2019 and above.


Toolsets – Outstanding

Docked Toolset Disappears With Fullsceen/Expert Mode
We have an issue where hitting ctrl space-bar and or shift space-bar for full-screen modes will kill a docked toolset window, the docked Toolset will disappear. In Maya 2020 removing these docked windows can cause Maya to crash.

We are looking into this issue, it’s been very tough to track down.


Joints Controls – Outstanding

Controls Only Partially Undo
2.2.3 and above we’ve added undo support for Control Creator. You may notice some extra controls in at the world center, you can delete these extra controls yourself.


Hotkeys – Note

While upgrading be sure to upgrade your hotkeys as well, you can do this after loading Maya with the button…

Zoo Preferences > Hotkeys > Zoo Hotkey Editor > Update Zoo Hotkeys

There will be a note in the Change Log if we have upgraded hotkeys.


Mirror Hotkey – Fixed

Mirror Polygon
The mirror polygon tool (shift M) is broken in Maya 2019.0, this issue is not related to Zoo Tools. Please upgrade Maya to version 2019.2 or higher.


Zoo Tools Pro 2
Maya 2017-2020

Last Updated

September 2020