RenderQueue Object
app.project.renderQueue
Description
The RenderQueue object represents the render automation process, the data and functionality that is available through the Render Queue panel of a particular After Effects project. Attributes provide access to items in the render queue and their render status. Methods can start, pause, and stop the rendering process. The RenderQueueItem object provides access to the specific settings for an item to be rendered.
Attributes
RenderQueue.canQueueInAME
app.project.renderQueue.canQueueInAME
This functionality was added in After Effects 14.0 (CC 2017)
Description
indicates whether or not there are queued render items in the After Effects render queue. Only queued items can be added to the AME queue.
Type
Boolean; read-only.
RenderQueue.queueNotify
app.project.renderQueue.queueNotify
This functionality was added in After Effects 22.0 (2022)
Description
Read or write the Notify property for the entire Render Queue.
This is exposed in the UI as a checkbox in the lower right corner of the Render Queue panel.
Type
Boolean; read/write.
RenderQueue.items
app.project.renderQueue.items
Description
A collection of all items in the render queue. See RenderQueueItem object.
Type
RQItemCollection object; read-only.
RenderQueue.numItems
app.project.renderQueue.numItems
Description
The total number of items in the render queue.
Type
Integer; read-only.
RenderQueue.rendering
app.project.renderQueue.rendering
Description
When true, the rendering process is in progress or paused. When false, it is stopped.
Type
Boolean; read-only.
Methods
RenderQueue.item()
app.project.renderQueue.item(index)
Description
Gets a specified item from the items collection.
Parameters
| Parameter | Type | Description |
|---|---|---|
index | Integer, in the range [0..numItems] | The position index of the item. |
Returns
RenderQueue.pauseRendering()
app.project.renderQueue.pauseRendering(pause)
Description
Pauses the current rendering process, or continues a paused rendering process. This is the same as clicking Pause in the Render Queue panel during a render. You can call this method from an RenderQueueItem.onStatusChanged or app.onError callback.
Parameters
| Parameter | Type | Description |
|---|---|---|
pause | Boolean | true to pause a current render process, false to continue a paused render. |
Returns
Nothing.
RenderQueue.render()
app.project.renderQueue.render()
Description
Starts the rendering process. This is the same as clicking Render in the Render Queue panel. The method does not return until the render process is complete. To pause or stop the rendering process, call RenderQueue.pauseRendering() or RenderQueue.stopRendering() from an onError or onstatus callback.
- To respond to errors during the rendering process, define a callback function in app.onError.
- To respond to changes in the status of a particular item while the render is progressing, define a callback function in RenderQueueItem.onStatusChanged in the associated RenderQueueItem object.
Parameters
None.
Returns
Nothing.
RenderQueue.showWindow()
app.project.renderQueue.showWindow(doShow)
Description
Shows or hides the Render Queue panel.
Parameters
| Parameter | Type | Description |
|---|---|---|
doShow | Boolean | When true, show the Render Queue panel. When false, hide it. |
Returns
Nothing.
RenderQueue.stopRendering()
app.project.renderQueue.stopRendering()
Description
Stops the rendering process. This is the same as clicking Stop in the Render Queue panel during a render. You can call this method from an RenderQueueItem.onStatusChanged or app.onError callback.
Parameters
None.
Returns
Nothing.
RenderQueue.queueInAME()
app.project.renderQueue.queueInAME(render_immediately_in_AME)
This functionality was added in After Effects 14.0 (CC 2017)
Description
Calls the Queue In AME command. This method requires passing a boolean value, telling AME whether to only queue the render items (false) or if AME should also start processing its queue (true).
This requires Adobe Media Encoder CC 2017 (11.0) or later.
When AME receives the queued items, it applies the most recently used encoding preset. If render_immediately_in_AME is set to true, you will not have an opportunity to change the encoding settings.
Parameters
| Parameter | Type | Description |
|---|---|---|
render_immediately_in_AME | Boolean | Telling AME whether to only queue the render items (false) or if AME should also start processing its queue (true). |
Returns
Nothing.
Example
The following sample code checks to see if there are queued items in the render queue, and if so queues them in AME but does not immediately start rendering:
// Scripting support for Queue in AME.
// Requires Adobe Media Encoder 11.0.
if (app.project.renderQueue.canQueueInAME === true) {
// Send queued items to AME, but do not start rendering.
app.project.renderQueue.queueInAME(false);
} else {
alert("There are no queued item in the Render Queue.");
}Last updated on Jun 7, 2026