Nuke ''

I’ve never managed to get ‘Submit for publish’ in Nuke working. I’m trying to dig into the code to find a fix but my journey into the SG .py files has revealed an interesting tangle of files inheriting data from (to my untrained eye) obscure sources.

So question 1:
What’s the best way of navigating up the hereditary stream? I get as far as ‘HookBaseClass’ then am a bit lost.

The SG dev tutorials and docs do shed some light, but I’ve yet to get a clear method of approach when fixing something.

My current problem is getting the submit for review working in Nuke.

I’m getting this error in Nuke’s SG publish GUI:

Traceback (most recent call last):

  File "C:\Users\STEVE\AppData\Roaming\Shotgun\bundle_cache\app_store\tk-multi-publish2\v2.4.1\python\tk_multi_publish2\api\plugins\", line 282, in _handle_plugin_error


  File "C:\Users\STEVE\AppData\Roaming\Shotgun\bundle_cache\app_store\tk-multi-publish2\v2.4.1\python\tk_multi_publish2\api\plugins\", line 198, in run_publish

    self._hook_instance.publish(settings, item)

  File "C:\Users\STEVE\AppData\Roaming\Shotgun\bundle_cache\app_store\tk-nuke\v0.12.5\hooks\tk-multi-publish2\basic\", line 272, in publish

    raise Exception("Review submission failed. Could not render and "

Exception: Review submission failed. Could not render and submit the review associated sequence.

Also get this exception:

'sg_publish_data' was not found in the item's properties. Review Submission for 'path/to/sequences/AB/AB_001/comp/work/images/AB_001_comp_v002_output/AB_001_comp_v002_output.%04d.jpg' failed. This property must be set by a publish plugin that has run before this one.

So it’s looking in ‘’ for:


    self._hook_instance.publish(settings, item)

I can find these in my local Appdata folder but not in my main install so I’m assuming that I need to look in ‘’ to get at this problem.

Looking at this file I can see that its sucking settings and info for the item from higher up the hereditary chain ‘HookBaseClass’.

So looking for where the ‘sg_publish_data’ is set in ‘’ I see line 225:
sg_publish_data ="sg_publish_data")

question 2
So where upstream is ‘’ is being set? I suspect in the nuke but ‘sg_publish_data’ is not present in there and is also a child of the ‘HookBaseClass’

Any insights into this would be gratefully appreciated.


1 Like

Hey Steve,

Thanks for your questions! I’ll get them in front of our Toolkit experts so they can weigh in.

1 Like

Thanks Brandon

Hi @steveprimary,

The Short Answer:

Assuming you have not added custom code or modified the config too much, you just need to make sure you have Publish to Shotgun checked on the item that you are submitting for review


The Long Answer:

First, here’s the documentation for the publisher API. Most of the concepts involved in solving this problem are explained there. But here’s the breakdown for your specific problem. Hopefully going through it like this will help you debug future issues as well.

In the above screenshot, under the ShorgunWrite1 item you see two plugins. These correspond to plugins that were defined in the config.

These plugins are run in order and act on the same item in memory. To get to the bottom of your problem you want to look at the code for these two plugins. You can figure out where those live by looking at the hook settings.

For the first plugin since we are looking at the settings for tk-multi-publish2, {self} refers to tk-multi-publish2. Therefore


can be found under the tk-multi-publish2 app folder:


Where the app exists on your file system depends on how app_locations.yml is configured, but if you haven’t changed anything there, you can find the app in your bundle cache folder. Here’s how to find your cache location if you need it.

For the second plugin, the hook path is


We are running the tk-nuke engine when in Nuke, so to find this publish hook we need to look under tk-nuke which again should be in your bundle cache.


Now that you know where to find the code you can see that the first plugin sets the values that are expected to exist in the second plugin.

The idea for the combination of these two plugins is that you are submitting for review something that is published (and will not change). So the workflow is to publish the source files first, then create a SG Version from them for review. The version is linked to the publish as well. the first plugin does the file publish and stores the information in the item for the second publish to use.

You mentioned inheritance so I wanted to clarify that as well. I think what you’re coming across in the documentation is referring to hook inheritance that is driven by the config and not a python inheritance as I suspect you think it means.

In the python files you’ll see that all the hooks inherit from HookBaseClass. But the hook mechanism in the config allows you to essentially treat these base hooks as mixins and combine them to get all the functionality you need while reusing code. You can see an example of this in the tk-multi-publish2 config:
  collector: "{self}/{engine}/tk-multi-publish2/basic/"

The collector defined here does not exist in any python file. It is actually a combination of the tk-multi-publish2's and tk-nuke's

If the quick fix is not enough for you and you need to modify these hooks, checkout the Customizing Publish Workflows video. It’s a great place to start.

I hope that helps.



Thanks Ehsan, appreciate your time in putting your reply together. You’ve clarified a couple of things for me.
There is something broken with my setup which I think you’ve given me enough to start to figure out.