Skip to content

Troubleshooting

The status bar at the bottom of the panel shows the most recent event. A full log is written to Documents/BatchRender; click Log in the status bar to reveal it. When reporting a bug, include the relevant log lines.

The log is safe to share: sign-in credentials are never written to it.

My unsaved changes disappeared after a batch Either a row’s project column switched to another project, which closes the open one without saving (Comps and projects), or Render from a temporary copy is on, which reopens your project from disk after every row. Save before starting a batch.

“Comp not found in project: …” The comp value does not match any composition name in the open project. Names must match exactly, including case. Leading and trailing spaces in the cell are ignored.

“No comp specified for this row” The row’s comp cell is empty. Every row must name the comp it renders.

“… has no comp column” The batch or agent was stopped before the first render because the data source has no comp column at all. Add one, then start again.

A Ctrl+K link in a Google Sheets cell is ignored Put the URL in the cell as plain text. See Linking to images and video.

“Column ‘…’ holds a link that was not downloaded” The row fails because the link could not be used as a file. The link is either a share link from a service other than Google Drive, or a direct link whose address does not end in a file extension (common with image CDNs, for example .../photo.png/m/750x0). See Files from Links for which links work.

Text or footage does not change Column names must exactly match the text layer name (for text) or the footage item name in the project panel (for footage). Check for trailing spaces in your sheet’s header row and in layer names.

The Render Settings or Output Module dropdown is empty This can happen on a fresh After Effects install that has not saved its template list yet. Open the Render Queue once, quit After Effects so it saves its preferences, then start it again. Until then, type the template name into a render-settings / output-module column; the column value is applied regardless of the dropdown.

“Footage not found for ‘…’” The row fails because the file does not exist at the path shown. Cell values are resolved against the Footage Path setting. Verify the path is set and the file exists at <footage path>/<cell value>. Downloaded files ignore the Footage Path; see Files from Links.

A row renders with the previous row’s image Its footage cell is empty. An empty cell leaves the footage item unchanged, so it keeps the file the row before used. The log and br-warnings say Column '...' is empty. Footage stays .... Fill in the cell to swap it.

“Output module template not found: ‘…’” / “Render settings template not found: ‘…’” The template named in the dropdown or in the row’s output-module / render-settings column does not exist in After Effects. Check the spelling; right-click a dropdown to copy an exact name.

“Save your After Effects project first” The project has never been saved. Rendering and previewing both need a saved project. Save it anywhere and try again. See Save your project first.

“Could not download …” / “Google Drive returned a web page instead of the file” / “The link returned a web page, not a file” The link is not publicly readable. For Google Drive: open the file, Share, and set General access to Anyone with the link. The row fails and the batch continues with the next row.

“Row N is empty or past the end of the data” Your Start/End range extends past the last data row, or the row is blank. The row is skipped and the batch continues. See Row numbering.

“Not signed in to Google” / “Not signed in to Airtable” The panel opened with a Google Sheets or Airtable connection, but that service’s sign-in could not be restored, for example because it expired. Open Sheets or Airtable and sign in again; your connection is kept.

A path does not resolve Output, footage and watchfolder paths accept both \ and / separators. Check the path exists and is reachable, and look at the log line for the exact path that was attempted.

Renders overwrite each other Two rows produced the same output filename. Give every row a unique output value. See Output filenames.

Google/Airtable sign-in never completes Make sure you complete the consent screen in the browser tab that opened. Sign-in finishes over a connection on your own computer, so firewalls or security software that block local (localhost) connections can stop it from reaching the panel.

“… sign-in timed out. Start it again from the panel.” The browser did not finish signing in in time. Click Sign in again and complete the consent screen in the new tab.

“The file is … above the … maximum download size” A link or attachment in the row points at a file larger than the limit in Settings. Raise the limit if the file is expected.

“The download was interrupted” / “The download was incomplete” The connection dropped while a file was downloading. The partial file is discarded. Render the row again; if it keeps happening, check the link opens in a browser.

My spreadsheet does not appear in the Google list By design BatchRender can only see files you picked. Click Browse Drive and select the spreadsheet once; it stays in the list afterwards.

“Rate limited, retrying…” Google and Airtable limit how quickly their data can be read and written. BatchRender waits and continues on its own; no action needed.

The agent never picks up my row Check that the status column exists, the cell reads ready in lowercase (Ready is not picked up), and the row’s file, worksheet or view is connected. See Status write-back.

A row failed and is not retried Intentional. Fix the cause, then set the status back to ready.

Panel does not appear under Window → Extensions Confirm the ZXP installed without errors and that your After Effects version is 2022 (22.0) or newer, then restart After Effects. BatchRender is an After Effects extension only; it does not appear in other Adobe applications.

A “Script Alert” dialog appears when the panel opens Restart After Effects, especially right after installing or updating. If the alert comes back, report it with the log.

Delivery columns stay empty The status bar names missing br- columns when a run starts. See Write delivery information back to source for column names and when fields are written.

If none of the above solves your problem, contact support.