Knowledgebase: Official ZBrush Plugins
ZBrush to Photoshop CC Readme
Posted by Matthew Yetter, Last modified by Joseph Drust on 13 June 2019 03:46 PM

ZBrush to Photoshop CC v4.2 for ZBrush 2019

(This plugin has had limited testing and could contain potential bugs; please save your work before using!)


  • Pixologic's ZBrush 2019 (ZBrush should say '2019' in the top left corner) or above.
  • Adobe Photoshop CC

Installation Instructions (for ZBrush 2019)

1. Close ZBrush 2019
2. Extract the Zip file
3. Copy the contents of the folder ZBrushToPhotoshop_Install ('ZBrushToPhotoshop_2019.zsc' and the 'ZBrushToPhotoshopData_2019' folder) to Pixologic/ZBrush 2019/ZStartup/ZPlugs64/
4. Launch ZBrush
5. ZBrush to Photoshop will be located in the ZPlugins Tab at the top [ZPlugin:ZBrush To Photoshop]
6. Initial running of the Plugin will have you choose the location of the Photoshop executable on your machine.
6. This plugin has had limited testing and could contain potential bugs; please save your work before using!!

Usage Video


Q. The Plugin is not showing up under the plugins tab?
A. Make sure the *.ZSC file and the Folder (with its contents) are extracted correctly to Pixologic\ZBrush 2019\ZStartup\ZPlugs64\


Pixologic\ZBrush 2019\ZStartup\ZPlugs64



Flat Color.zmt
MatCap Gray.zmt

Lights (folder)

Back Left Light.zli
Back Right Light.zli
Back Top Light.zli
Front Light.zli
Left Light.zli
Right Light.zli

Passes (folder)



Q.The plugin is working but Photoshop CC is not Launching?
A. Make sure you have the correct location of the Photoshop CC executable set on your machine. This can be done by clicking [ZPlugin:ZBrush to Photoshop:R]. On the initial click of 'Send To Photoshop' the plugin should ask you to set this location as well.

Q.I have the Photoshop executable linked but Photoshop is still not sending the passes?
A. Make sure you have a Photoshop CC executable selected. The plugin will not work with non CC versions of Photoshop.

Q. I am getting the warning that "SSS Pass could not be generated from current lighting?"
A. The lights that are currently associated with your ZBrush scene may be corrupted and are not allowing for the SSS Pass to be created (this can be caused by loading in a Project (*.ZPR) file from a older version of ZBrush.) One way to solve this is to save the current tool out as a *.ZTL file, Restart ZBrush, and load this new *.ZTL file back in (this will open the file in a new ZBrush scene with default lighting.) 

Q. Can I use my own light setup for the Lights Passes?
A. You can replace any of the Light *.zli files that are located in \Pixologic\ZBrush 2019\ZStartup\ZPlugs64\ZBrushToPhotoshopData_2019\Lights\ with your own custom lights (Just make sure to keep the naming the same as the originals.) 

Q. Can I use my own Custom Materials for the Passes?
A. The plugin contains 5 Custom Material slots. These allow you to load your Material into ZBrush then store it in one of these slots as a Pass. You can also take this one step further and replace any of the default materials that are used when creating the passes by replacing the corresponding *.zmt files. 

List of *.zmt files used for each of the default passes:

\Pixologic\ZBrush 2019\ZStartup\ZPlugs64\ZBrushToPhotoshopData_2019\

BasicMaterial.zmt = Albedo, Lights
BumpViewerMaterial.zmt = Color Bump
Flat Color.zmt = PolygroupID, SubtoolID, SubtoolMask, Wireframe
MatCap Gray.zmt = Structure
ReflectedMap.zmt = Spec
TangentSpaceNormal.zmt = TS Normal
Texture40Normal.zmt = OS NormalBrushToPhotoshop_2019.zsc

Q. The plugin is working but Photoshop is not Launching? (For 4R7 P3 and ZBrush 4R8 versions of the plugin)
A. The plugin uses a ExtendScript *.JSX file to transfer the passes to Photoshop CC. Make sure that Photoshop CC is the default application to open up the *.JSX file.

On Windows:

  1. Open Default Programs by clicking the Start button and then clicking Default Programs.
  2. Click Associate a file type or protocol with a program.
  3. Click the *.JSX file type in the list.
  4. Click Change program.
  5. Click the program that you want to use as the default for the file type you selected, or click the arrow next to Other Programs to show additional programs (Photoshop CC.)
    • If you don't see Other Programs, or your program is not listed, click Browse to find the program you want to use, and then click Open. If no other programs are installed that are able to open the file type or protocol, your choices will be limited.
    • If you don't see the program you want to use as the default, click the arrow next to Other Programs to see a list of programs available on your computer.
  6. Click OK.

On Mac OS X:

  1. Navigate to the ZStartup\ZBrushToPhotoshop_4R7\Passes\ directory in Finder.
  2. Select the *.JSX file
  3. Open the File Menu at the top and select ‘Get Info’
  4. Click the “Open with:” sub menu, then click on the context menu and select the new application to associate all files of this format type with (Photoshop CC.)
  5. Click the “Change All” button and confirm the change.

Q. My Hardrive is running out of space, how can I clear the cache for the Plugin?
A. Click the 'Clear Layer Cache' Button. This will delete all the renders generated from ZBrush and stored in the Passes folder. (Use caution as this will break Smart Linking.)