MANUAL / SCRIPTING & EXPRESSIONS

Expression

The modifier that runs an After Effects-style expression on a layer property.

What it does

The Expression modifier sits in a layer's modifier stack (with Wiggle, Set Driver/Driven and Linear). Its result replaces — or combines with — the value of the property it drives. Expressions run after Drivers, in preview, export and Frame Rate holds.

How to use it

  1. Select the layer and add a modifier (+ Modifier), choosing Expression, or switch an existing modifier's kind menu to Expression.
  2. Under drives, pick the target layer and property.
  3. Type the expression in the text box. It starts as value (the property unchanged).
  4. Press ⌘↩ (Ctrl+Enter) or click away to apply. Esc puts back the last applied text.
  5. If it has an error, the box turns red and the message shows underneath, e.g. Line 2, column 5: unknown name "wigle".

Scripts can set one too: prop.expression = "wiggle(2, 30)".

Options

NameWhat it doesDefault/range
Enable dotTurns the modifier on or off.On
KindWiggle, Set Driver/Driven, Linear or Expression.Expression
drivesThe layer and property the expression writes.—
CombineHow the result meets the property's value: override, add, subtract, multiply, blend.override
InfluenceHow much of the result is applied.100%
Expression textThe expression.value
×Removes the modifier.—

What expressions can drive

Position (whole, X or Y), Scale (whole, X or Y), Anchor Point (whole, X or Y), Rotation, Opacity, the shape and text values Drivers can reach, and effect parameters.

Shortcuts

ActionMacWindows/Linux
Apply the expression⌘↩Ctrl+Enter
Cancel the editEscEsc

While the box has focus, typing doesn't trigger app shortcuts (Space doesn't play).

Tips

  • macOS smart quotes (“ ” ‘ ’) are read as plain quotes.
  • valueAtTime(t) and loopOut() read the keyframed value before modifiers, as AE does.