Layers, media and SVG
Add editable text, shapes, images, footage, audio, HTML snippets and SVG without flattening the project.
Every editable element carries data-jc-clip and a stable id. Its data-jc-kind selects the focused Studio controls and validation rules.
Headphones product cinema
Real footage, product images, text and graphic layers stay independently editable across three scenes.
Layer kinds
| Kind | Best for |
|---|---|
text | Headings, body copy, labels and editable text effects |
shape | Rectangles, ellipses, paths, gradients and accents |
image | Photos, screenshots, generated images and editable SVG |
video | Footage with crop, trim, speed, volume and loop controls |
audio | Music, narration and sound effects |
html | Safe static markup that behaves like an ordinary layer |
caption | Word-timed transcript segments |
scene, group | Hierarchy and local compositions |
custom | Isolated DOM, SVG, Canvas 2D or WebGL code |
lottie | Ready-made Lottie animations (Bodymovin JSON), played frame by frame |
Media references
<video id="product-demo" data-jc-clip data-jc-kind="video"
data-jc-name="Product demo" data-jc-start="0" data-jc-duration="4.63"
data-jc-track="1" data-jc-media-start="1.2" data-jc-media-end="5.83"
data-jc-playback-rate="1" data-jc-volume="0.85"
src="jsoncut-media://media_product_demo"></video>Upload substantial media with POST /api/v2/media and store the returned jsoncut-media://... reference. Small Base64 data URLs remain available within request-size limits.
Editable SVG
<div id="mark" data-jc-clip data-jc-kind="image" data-jc-name="Vector mark"
data-jc-start="0" data-jc-duration="5" data-jc-track="3">
<svg viewBox="0 0 100 100" aria-hidden="true">
<path data-jc-vector-path d="M50 4 96 50 50 96 4 50Z" fill="#ff9418" />
</svg>
</div>SVG layers retain their source. Declared colors can be changed through ordinary Studio color controls without converting the vector to a bitmap.
Lottie animations
<div id="confetti" data-jc-clip data-jc-kind="lottie" data-jc-name="Confetti"
data-jc-start="1" data-jc-duration="3" data-jc-track="5"
data-jc-playback-rate="1.5" data-jc-loop="true"
src="jsoncut-media://media_confetti"
style="left:660px;top:240px;width:600px;height:600px"></div>Upload the .json file like any other media (kind lottie, MIME type application/json, up to 20 MB). The upload is checked for size, frame rate, in and out point and layers; width, height and duration come from the file. Images inside the animation must be embedded (data URLs); files that load images from elsewhere are rejected.
The animation is set to the exact frame of the timeline on every frame, so preview and export match and seeking backwards gives the same picture. Speed, source in/out point and loop work as for video; without loop, the layer holds its last frame. Expressions are not evaluated. A Lottie layer has no sound. It keeps the animation's aspect ratio inside its box.
Colours of the file can be replaced per layer without changing the file: data-jc-lottie-colors='{"#ff6b35":"#3aa0ff"}' (solid fills and strokes, #rrggbb). Studio lists the file's colours in the inspector. The Library has about 50 ready animations in groups (icons, reactions, arrows and hints, status, transitions, backgrounds; for example bell ring, heart pop, fireworks, curved arrow, swipe up, circle wipe, wave lines, equalizer) whose colours are insert properties.
Required clip identity and timing
Every editable tag needs a unique stable id (a letter first, then up to 159 letters, digits, _, :, . or -), data-jc-clip, a valid data-jc-kind, non-negative data-jc-start, positive data-jc-duration and a non-negative integer data-jc-track.
A higher track draws in front of the lower tracks it overlaps in time, as on an editing timeline; layers that do not overlap can share a track. Write sibling layers back to front. Edits keep the order and the tracks in agreement: a layer given a higher track moves in front, and a layer brought forward gets a higher track. Sound uses tracks of its own.
<h2 id="feature-title" data-jc-clip data-jc-kind="text"
data-jc-name="Feature title" data-jc-start="1.2"
data-jc-duration="3.4" data-jc-track="4">One source.</h2>data-jc-name is strongly recommended for people and Agents even though the stable id is the machine identity.
Media controls
| Attribute | Applies to | Meaning |
|---|---|---|
src | image, video, audio, lottie | Owned media reference, HTTPS URL allowed by policy, or bounded matching data URL |
data-jc-media-start, data-jc-media-end | video, audio, lottie | Source in- and out-point in seconds |
data-jc-playback-rate | video, audio, lottie | Source playback multiplier (0.5–2) |
data-jc-volume | video, audio | Base volume (0 to 1) before volume keyframes |
data-jc-fade-in, data-jc-fade-out | video, audio | Audio fade duration in seconds |
data-jc-loop | video, audio, lottie | Repeat the source until the layer ends |
data-jc-muted | video, audio | Silence the layer |
data-jc-key | image, video | Remove a plain background without AI; see Vectors and compositing |
Image projects reject video, audio, caption and scene kinds. Every image layer must use start 0 and duration 1.