# Specification

Welcome to the official documentation for the dotLottie Animation Format.

This manual contains formal specification and documentation for the dotLottie file format, offering insights into its structure and features.

The main target audience for this manual are developers that want to create tools within the dotLottie ecosystem as it provides details about its internals.

The dotLottie specification is available in two versions:

v2.0 Latest · Recommended

Designed to support more features and capabilities for production workflows.

ThemingState machinesFonts
Read the v2.0 spec
v1.0 Widely supported

Features commonly supported across most tools and players.

CompressionMultiple animationsImage assets
Read the v1.0 spec

Not sure which? Start with v2.0 — recommended for new projects.

# What's new in v2.0

Breaking Changes:

  • Updated dotLottie ZIP structure for smaller file size:
    • animations/ folder is now a/
    • images/ folder is now i/
  • Removed animation playback controls from manifest.json
  • Added initial property to manifest.json to specify the initial animation/state machine to play

New Features:

← Tools →