JsonCutDocs

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.

Rendered output

Headphones product cinema

Real footage, product images, text and graphic layers stay independently editable across three scenes.

Video1920 × 108012 secondsEditable V2 source

Layer kinds

KindBest for
textHeadings, body copy, labels and editable text effects
shapeRectangles, ellipses, paths, gradients and accents
imagePhotos, screenshots, generated images and editable SVG
videoFootage with crop, trim, speed, volume and loop controls
audioMusic, narration and sound effects
htmlSafe static markup that behaves like an ordinary layer
captionWord-timed transcript segments
scene, groupHierarchy and local compositions
customIsolated DOM, SVG, Canvas 2D or WebGL code
lottieReady-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

AttributeApplies toMeaning
srcimage, video, audio, lottieOwned media reference, HTTPS URL allowed by policy, or bounded matching data URL
data-jc-media-start, data-jc-media-endvideo, audio, lottieSource in- and out-point in seconds
data-jc-playback-ratevideo, audio, lottieSource playback multiplier (0.5–2)
data-jc-volumevideo, audioBase volume (0 to 1) before volume keyframes
data-jc-fade-in, data-jc-fade-outvideo, audioAudio fade duration in seconds
data-jc-loopvideo, audio, lottieRepeat the source until the layer ends
data-jc-mutedvideo, audioSilence the layer
data-jc-keyimage, videoRemove 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.