Composition

Animation

Top level object, describing the animation

Composition Diagram for Animation Animation Visual Object Composition
Attribute Type Title Description
nm string

Name

Human readable name, as seen from editors and the like
layers array of Layer

Layers

Layers
ver integer

Specification Version

Specification version this Lottie is targeting. This is a 6 digit number with version components encoded as MMmmpp, with MM being major version, mm being minor and pp being patch.
fr number

Framerate

Framerate in frames per second
ip number

In Point

Frame the animation starts at (inclusive; usually 0)
op number

Out Point

Frame the animation stops/loops at (exclusive). The frame at op is NOT rendered; the animation duration in frames is op - ip.
w integer

Width

Width of the animation
h integer

Height

Height of the animation
assets array of Asset

Assets

List of assets that can be referenced by layers
markers array of Marker

Markers

Markers defining named sections of the composition.
slots object

Slots

Dictionary of slot ids that will replace matching properties.
meta Metadata

Metadata

Metadata about the animation

Time and Duration

The animation's playable frame range is defined by ip (In Point, inclusive) and op (Out Point, exclusive). The frame at op is NOT rendered; the animation loops or stops at that boundary.

The total duration in frames is op - ip, and the duration in seconds is (op - ip) / fr.

Implementations MUST treat op as an exclusive boundary. op MUST be strictly greater than ip.

Example: ip: 0, op: 30, fr: 30 defines a 30-frame, 1-second animation playing frames 0..29.

Versioning Guidelines

The Lottie specification version number uses a semantic versioning system, tools implementing the specification SHOULD consider the following guidelines:

Authoring Tools

Authoring tools SHOULD specify the latest version of the Lottie Specification. They MAY allow the major version to be configurable to facilitate playback on a wider range of players. Changing the targeted major version MAY also require changes to the produced animation in the case of any breaking changes between major versions.

Animation Players

Players SHOULD determine what major versions they support and handle breaking changes across supported major versions. Players SHOULD be able to handle animations that specify both newer and older versions of the Lottie specification and SHOULD issue a warning if:

Metadata

The meta property provides a place to store information about the animation itself, such as the authoring tool, author name, and keywords.

Attribute Type Title Description
g string

Generator

Name and version of the software that generated this animation
a string

Author

Author of the animation
d string

Description

Human-readable description of the animation
k array of string

Keywords

List of keywords relevant to the animation content
custom object

Custom Metadata

Object where authors can store any custom data. The contents of this property are not validated by the schema.

Example:

{
    "meta": {
        "g": "MyTool 1.0",
        "a": "Aidos S",
        "d": "Loading spinner animation",
        "k": ["spinner", "loading", "ui"],
        "custom": {
            "project_id": "abc-123",
            "exported_at": "2025-01-15T10:30:00Z"
        }
    }
}

Composition

An object that contains a list of layers

Composition Diagram for Composition Composition Precomposition Animation
Attribute Type Title Description
layers array of Layer

Layers

Layers