Scripting overview

A script asset runs your own ExtendScript code inside the job’s After Effects project, right before the render starts. Use it when a change needs logic: loops, conditions, reading data files, or restructuring compositions.

When to use a script

Reach for the simplest asset type that does the job. A script is the most flexible option, and also the one you have to maintain.

You want to	Use
Replace text, images, video, or audio in a layer	`text`, `image`, `video`, `audio` assets
Set one property or expression on a layer	A `data` asset
Style text, change layer timing, hide or remove layers	A function
Anything that needs logic, loops, files, or several steps	A `script` asset

Before you start

Scripting is turned on per team. If your team doesn’t have it, the API rejects any job with a script asset with 403 and the error code SCRIPTING_DISABLED. Contact [email protected] to get it turned on.
Scripts are ExtendScript. That’s the JavaScript dialect After Effects uses for scripting, based on ECMAScript 3. Use var and function. let, arrow functions, and template literals don’t work. Nexrender adds JSON.parse, JSON.stringify, and the array methods forEach, filter, and indexOf, which plain ExtendScript lacks.
Scripts run in a sandbox by default. They can use the After Effects scripting API and files in the job’s folder, but not the rest of the machine. See Sandbox and limits.

Your first script

Host the script anywhere the render node can download it, and reference it from the job:

{
  "template": {
    "id": "YOUR_TEMPLATE_ID",
    "composition": "main"
  },
  "assets": [
    {
      "type": "script",
      "src": "https://example.com/scripts/set-title.jsx",
      "parameters": [
        { "key": "title", "value": "Hello from a script" }
      ]
    }
  ]
}

var title = NX.get("title") || "Default title";

nexrender.selectLayersByName("main", "Title", function (layer) {
    layer.property("Source Text").setValue(title);
});

nexrender.log("Title set to: " + title);

NX.get("title") reads a value from the job’s parameters, and nexrender.selectLayersByName finds the layer. Script assets and parameters and Helper functions cover both in detail. src accepts:

A public https:// URL. Google Drive and Dropbox share links work too: Nexrender converts them to direct downloads.
An inline data: URL, for short scripts or quick tests: data:text/javascript;base64, followed by the script encoded in Base64.

How a job runs your script

Download

Nexrender downloads the template and every asset into a folder for the job.

Assemble

It builds one After Effects script from your assets, in the order you list them in assets. Footage replacements, text and data assets, functions, and scripts all apply in that order, so a script sees every change made by the assets above it.

Run

After Effects opens the project and runs the assembled script, then saves the project.

Render

After Effects renders the job’s composition.

If a script throws an error, the job stops before rendering and fails. Start your own error messages with nexrender: to make them the job’s error word for word. See Stop the job with a clear error.

See what your script did

Lines your script writes with nexrender.log go into the job’s render log, prefixed with NX:. Read the log with GET /jobs/{id}/logs, which returns it as plain text, or with the CLI:

nexrender job logs JOB_ID

Render log (excerpt)

NX: Title set to: Hello from a script

Next steps

Script assets and parameters

Every field of a script asset, and how to pass values into your script

Helper functions

The nexrender object: find compositions and layers, replace footage, log

Examples

Tested scripts for common tasks

Sandbox and limits

What scripts can do on Nexrender Cloud, and the limits that apply

Essentials

Managing Templates

Rendering Jobs

Scripting

Fonts Management

When to use a script

Before you start

Your first script

How a job runs your script

See what your script did

Next steps

Script assets and parameters

Helper functions

Examples

Sandbox and limits

​When to use a script

​Before you start

​Your first script

​How a job runs your script

​See what your script did

​Next steps

Script assets and parameters

Helper functions

Examples

Sandbox and limits

When to use a script

Before you start

Your first script

How a job runs your script

See what your script did

Next steps