Skip to content
Limited timeStarter is now $9 a month instead of $20.See plans
charmotion

What Is a Lottie Animation? LottieFiles, .json and .lottie Explained

By the Charmotion team · Updated · How we write guides

Cover illustration for the guide: What Is a Lottie Animation? LottieFiles, .json and .lottie Explained, with Charmotion demo characters

A Lottie animation is a vector animation stored as JSON data (a .json file, or a zipped .lottie file) that a small player library draws in real time on websites and in iOS, Android and React Native apps. It usually starts in After Effects or Lottie Creator, stays sharp at any size and can loop, play on scroll or react to taps.

Key takeaways

  • Lottie is a JSON format for vector animation: shapes, layers and keyframes, drawn live by a player, not stored as video frames.
  • Hernan Torrisi's Bodymovin exporter (2015) and Airbnb's open-source players (February 2017) made it popular; the Lottie Animation Community published spec v1.0 in September 2024.
  • LottieFiles is a company and platform around the format: a large animation library, Lottie Creator, plugins and the dotLottie (.lottie) container.
  • Use lottie-web or dotlottie-web on the web, lottie-ios, lottie-android and lottie-react-native in apps.
  • Lottie needs a player, so it does not work in email or chat; some After Effects features are not supported on every platform.

What is a Lottie animation?

A Lottie animation is a description of motion, not a recording of it. The file lists vector shapes, layers, colors and keyframes as JSON, and a player library on the device redraws the animation every frame. Because nothing is stored as pixels, the same file stays sharp on a phone and on a 4K screen, and flat illustrations usually come out much smaller than the same motion as a GIF or video.

The format grew out of two pieces of work. According to the Lottie Animation Community, Lottie "was first created in 2015 by Hernan Torrisi," whose Bodymovin plugin exported After Effects compositions as JSON. In February 2017 Airbnb released open-source Lottie libraries for iOS, Android and React Native that played that JSON natively in apps, which is when the name spread.

In 2024 the format moved toward a formal standard. The Lottie Animation Community (LAC) is "a non-profit open source project hosted by The Linux Foundation" and operates under the Joint Development Foundation. On September 17, 2024 it announced the v1.0 Lottie JSON specification, which describes Lottie as "an open standard for efficient, scalable, and cross-platform animated vector graphics," and a minor 1.0.1 release followed on April 15, 2025.

So when people say "a Lottie," they mean any animation in this JSON format, whichever tool made it and whichever player shows it. It is the same idea as an SVG, extended over time.

What is inside a Lottie animation JSON file, and what is .lottie?

A Lottie file is ordinary JSON you can open in a text editor. The top-level object in the specification includes, among others:

KeyMeaning (per the Lottie spec)
frFrame rate in frames per second
ip / opThe frame the animation starts at and the frame it stops or loops at
w / hWidth and height of the animation
layersThe shape, image and other layers, each with its own keyframed properties
assetsReusable items, such as images or precompositions, that layers reference
markersNamed sections of the timeline, useful for playing one segment

The duration is simply (op - ip) / fr seconds. Images can be linked as separate files or embedded inside the JSON as base64 text, which is the most common reason a Lottie file turns out heavier than expected.

dotLottie (.lottie) is a newer container from LottieFiles: a ZIP archive that holds one or more Lottie JSON animations plus images, themes and state machines. It is usually smaller and adds features, but it needs a dotLottie-capable player. The full comparison is in dotLottie vs Lottie JSON.

What is LottieFiles, and are its animations free?

LottieFiles is a company and platform built around the format; it is not the format itself. As of November 2026 its site offers:

  • An animation library. The homepage advertises "800,000+ Free & Premium ready-to-use animations" (free and paid combined).
  • Lottie Creator, a browser-based animation editor that imports Lottie JSON, dotLottie and SVG and exports Lottie JSON, dotLottie, GIF, MP4, MOV and WebM.
  • Plugins for After Effects and Figma, plus integrations for tools such as Webflow, Framer and Canva.
  • dotLottie runtimes, the players for .lottie and JSON files on web and native platforms.
  • AI tools such as Lottie AI, which it says generates "fully editable, vector-based motion from a simple prompt."

Is it free? Partly. The LottieFiles help center says free animations are covered by the Lottie Simple License, which lets you "use commercially in business projects, websites, apps, and products," with attribution "not required" but encouraged. Premium animations need a paid plan. Lottie Creator "is free to use," but free users "can only export five animations." Paid plans on the pricing page start with Individual at $19.99 per user a month and Team at $24.99 per user a month, both billed annually (as of November 2026). Check the license shown on each animation's page before you ship it.

For free sources beyond LottieFiles, and for Rive files, see free Rive animations and Lottie alternatives.

How do you use a Lottie animation on a website or in an app?

You add a player library and point it at the file. The main official players, as of November 2026:

PlatformPlayerPlaysInstall
Weblottie-web (Airbnb)Lottie JSON, as SVG, canvas or HTMLnpm install lottie-web
Webdotlottie-web (LottieFiles), plus React, Vue, Svelte, Solid and Web Component wrappers.lottie and JSON, on a canvas via a WebAssembly enginenpm install @lottiefiles/dotlottie-web
iOS, macOS, tvOS, visionOSlottie-iosLottie JSONSwift Package Manager (the lottie-spm repo is recommended), CocoaPods or Carthage
Androidlottie-android, and lottie-compose for Jetpack ComposeLottie JSONGradle: com.airbnb.android:lottie
React Nativelottie-react-nativeJSON and .lottie (wraps lottie-ios and lottie-android)yarn add lottie-react-native

On the web, the smallest working example with lottie-web looks like this:

import lottie from "lottie-web";

lottie.loadAnimation({
  container: document.getElementById("hero"),
  renderer: "svg",
  loop: true,
  autoplay: true,
  path: "/animations/hero.json",
});

The returned instance has controls such as play, pause and setSpeed, which is how you tie playback to scroll or clicks. For a .lottie file, use new DotLottie({ canvas, src, autoplay: true, loop: true }) from dotlottie-web instead. Framework-specific setups are covered in adding animation to a website, Lottie in SwiftUI and Lottie and Rive in React Native and Flutter.

How do you create a Lottie animation?

There are four common routes, from most to least control:

  • After Effects plus an exporter. The classic route. Animate shape layers in After Effects, then export with Bodymovin or the LottieFiles for After Effects plugin, which exports "as Lottie JSON or dotLottie" and previews the result on web and mobile. The plugin installs free but needs a LottieFiles account, and "some limitations may apply."
  • Lottie Creator. A browser editor with no After Effects required. It can import SVG artwork, animate it with keyframes, add state machines and export JSON or .lottie.
  • Figma. The LottieFiles for Figma plugin converts frames, prototype flows and Smart Animate to Lottie or dotLottie, and can export prototype clicks, taps and hovers as dotLottie state machines.
  • Start from the library. Download a free animation and change its colors or timing in Lottie Creator.

Whichever route you take, design for the format: flat vector shapes, few layers and no heavy effects. A photo or a 3D render inside a Lottie is just a bitmap riding along in the JSON, and it will be larger than a video of the same thing.

What are the limits of Lottie animations?

  • It needs a player. Email clients, chat apps and social networks accept images and video, not JSON plus JavaScript. Use a GIF or a video there; see Lottie vs GIF.
  • Not every After Effects feature survives. Airbnb's supported-features table marks expressions, layer effects such as Fill, Tint and Tritone, and Auto Orient as supported on web but not in the native iOS and Android players, and mask modes such as Feather, Lighten, Darken and Difference as unsupported everywhere. Test on every platform you ship to, not only in a browser preview.
  • Interactivity depends on dotLottie. Plain JSON plays timelines; you script play, pause and segments in code. LottieFiles added state machines to Lottie Creator in September 2025. The dotLottie state machine spec supports playback states, tweened transitions, number, string, boolean and event inputs, pointer interactions (enter, exit, down, up, move, click) and actions such as SetTheme and OpenUrl. They run only in dotLottie players, not in lottie-web.
  • Complexity costs. File size grows with the number of layers, paths and keyframes, and embedded images bloat it fast. Many simultaneous animations can also cost CPU on low-end phones; numbers are in Rive vs Lottie performance.
  • Characters with many states get awkward. Each state is a separate timeline, so switching is a cut or a short tween rather than a blend between poses. Lottie vs Rive state machines compares the two models.

Lottie vs GIF vs video vs Rive: which should you use?

Disclosure: Charmotion is our product. We list it where it fits and say where other tools are better; every other fact links to its source.

Pick by where the animation will play and whether it must react to the user:

FormatBest forAvoid when
Lottie (JSON or .lottie)Flat vector UI motion from After Effects or Figma: icons, empty states, onboarding illustrationsThe place it plays cannot run a player, or the art is photographic or 3D
GIFEmail, chat, docs and READMEs where only an image is allowedAnywhere video plays; GIF is limited to 256 colors and on/off transparency
MP4 or WebM videoRendered, photographic or 3D motion; social posts; transparent overlays with WebM plus HEVCYou need it to scale without blur or react to input
Rive (.riv)Interactive characters and controls with many states, where "a state machine connects your timelines with logic"Your team's motion work already lives in After Effects and is mostly linear

The head-to-head details are in Rive vs Lottie and GIF vs WebM vs MP4 vs Rive. If you already have Lottie files and want Rive, see converting Lottie to Rive.

Where Charmotion fits: it does not make or export Lottie files. It animates one uploaded character or logo image into a Rive file with a state machine, plus MP4, GIF, transparent WebM and MOV on demand. If your pipeline needs Lottie specifically, use After Effects, Lottie Creator or the Figma plugin above. If you need an app character with idle, loading and success states, see how Charmotion works.

Make and add a Lottie animation to a website

  1. Design vector art. Draw flat shapes in Figma, Illustrator or Lottie Creator. Avoid photos, heavy effects and many layers.
  2. Animate it. Keyframe the shapes in After Effects or Lottie Creator, or turn a Figma prototype into motion with the LottieFiles for Figma plugin.
  3. Export. Export Lottie JSON for the widest player support, or .lottie if you want a smaller file, themes or state machines.
  4. Add a player. Install lottie-web for JSON or @lottiefiles/dotlottie-web for .lottie, and load the file into a container or canvas.
  5. Test on every platform. Check the animation in each browser and native player you ship to, since some After Effects features are not supported everywhere.

Frequently asked questions

Is Lottie a file format or a library?

Both names are used. The format is the Lottie JSON specification, now maintained by the Lottie Animation Community under the Linux Foundation. The libraries that play it, such as lottie-web, lottie-ios and lottie-android, are also called Lottie.

Is LottieFiles the same as Lottie?

No. Lottie is the open animation format and its players. LottieFiles is a company that runs a large animation library, Lottie Creator, design plugins and the dotLottie format and players.

Can I use free LottieFiles animations commercially?

Per the LottieFiles help center (November 2026), free animations are under the Lottie Simple License, which allows commercial use in websites, apps and products without required attribution. Premium animations need a paid plan. Check the license shown on each animation's page.

Can I open a Lottie file without code?

Yes. Import the .json or .lottie file into Lottie Creator, which is free to use, to watch and edit it. To use it in a product, you still need a player library, or a no-code builder that includes one.

Can I convert a Lottie animation to GIF or MP4?

Yes. Lottie Creator exports GIF, MP4, MOV and WebM, and so does the LottieFiles for Figma plugin. Expect the GIF to lose smooth edges and gradients because of its 256-color palette.

Quick answers from this guide

Sources

Related guides