Command · Import Lottie
lottie.import
Imports a Lottie animation (Bodymovin JSON from After Effects, LottieFiles) as a motion graphic: from a file ("path") or the JSON itself ("data").
- v1
- Capability EditProject
- Tool
lottie_import
Request
{
"command": "lottie.import",
"params": {
"at": "00:00:03:00",
"path": "D:/Motion/confetti.json",
"track": "V3"
}
}Parameters
atinteger | string- Place it as a clip starting here. Timecode in the sequence's rate ("00:01:02:03") or ticks.
datastring- The Lottie JSON itself.
durationinteger | string- The clip's length (default the animation's). Timecode in the sequence's rate ("00:01:02:03") or ticks.
pathstring- The .json file (UTF-8 path).
placement`targeted` | `freeTrackAtOrAbove` | `newTrack`- "targeted": on "track" (or the targeted video track), overwriting what is there; the default when "track" is given. "freeTrackAtOrAbove": the first unlocked video track from "track" (or the targeted one) upwards with nothing in the graphic's time range, a new top track when none is free; the default without "track", so nothing under the playhead is overwritten. "newTrack": a new video track on top.
saveAsobjectsaveAs.descriptionstring- Description.
saveAs.idstringRequired- Template id.
saveAs.namestringRequired- Template name.
sequenceinteger (1..)- Sequence id; only needed when the project has several.
trackstring | integer (1..)- A video track. Default: the first targeted unlocked video track. "V1" (bottom video track), "A2", ... or a track id.
Discussion
Imports a Lottie animation (Bodymovin JSON from After Effects, LottieFiles) as a motion graphic: from a file ("path") or the JSON itself ("data"). With "at" it becomes a clip there; with "saveAs" a template in the project's library (both are allowed). Shapes, fills, strokes, gradients, trims, transforms with their easing, text, masks and precomps come in; the report lists what was approximated or dropped (images, effects, mattes, expressions...).
Run it with wabcut-cli cmd <project> --json, from an MCP client as lottie_import, or from an extension. See Edit commands for requests, references and results.