# Heart animated icon

> MIT-licensed Heart animated icon: toggles between two states on click. Use it in React or shadcn/ui, or get the Lottie JSON or SVG.

Heart is a 0.33 s micro animation that toggles between two states on click; use it for like, favourite and bookmark buttons on cards. Click-to-toggle icons typically drive mute/unmute, show/hide password, menu/close, play/pause and like buttons. Also known as like, favorite and love.

## Facts

- Interaction: [Click toggle](https://useanimations.com/interactions/click-toggle). Toggles between two states on click, or switches immediately when reduced motion is preferred.
- Category: [Action](https://useanimations.com/categories/action)
- Duration: 0.33 s at 30 fps
- Artboard: 32 × 32 px
- Lottie size: 2.4 kB
- License: MIT, attribution optional ([Licencing & Terms](https://useanimations.com/licencing-and-terms))

## Files

- Lottie JSON: https://useanimations.com/icons/heart.json
- Static SVG (heart): https://useanimations.com/icons/heart/heart.svg
- ZIP (Lottie JSON and SVGs): https://useanimations.com/icons/heart.zip
- shadcn registry item: https://useanimations.com/r/heart.json
- Web page: https://useanimations.com/icons/heart

## React

```bash
npm install react-useanimations
```

```jsx
import UseAnimations from 'react-useanimations';
import heart from 'react-useanimations/lib/heart';

<UseAnimations animation={heart} size={32} />
```

## shadcn/ui

```bash
npx shadcn@latest add https://useanimations.com/r/heart.json
```

```tsx
import { AnimatedHeart } from '@/components/animations/heart';

<AnimatedHeart size={24} />
```

## HTML and lottie-web

```html
<div id="heart-icon" style="width: 48px; height: 48px"></div>

<script src="https://cdn.jsdelivr.net/npm/lottie-web@5.13.0/build/player/lottie_light.min.js"></script>
<script>
  const el = document.getElementById('heart-icon');
  const a = lottie.loadAnimation({ container: el, renderer: 'svg', loop: false, autoplay: false, path: 'https://useanimations.com/icons/heart.json' });
  const motion = matchMedia('(prefers-reduced-motion: reduce)');
  let isOn = true; // Frame 0 is on; the final frame is off.
  el.addEventListener('click', () => { isOn = !isOn; if (motion.matches) a.goToAndStop(isOn ? 0 : a.totalFrames - 1, true); else { a.setDirection(isOn ? -1 : 1); a.play(); } });
</script>
```

## Other versions

- [Heart V2](https://useanimations.com/icons/heart-v2): Heart V2 replays on every click and is longer at 1.33 s instead of 0.33 s.

## FAQ

### Can Heart be a controlled toggle?

Make it controlled: pass active and flip it in onClick, e.g. active={on} onClick={() => setOn(!on)}. true plays to the last frame and false back to the first; an icon that mounts with active already true starts there without animating, and with reduced motion it jumps instead of playing.

### Should the Heart icon be a <button>?

Put its events on a real button with the render prop: render={(events, icon) => <button aria-label="Heart" aria-pressed={on} {...events}><span {...icon} /></button>}. The animation itself stays aria-hidden, and aria-pressed tells screen readers which state is on.

### Can I color the fill of Heart separately?

Yes: strokeColor sets the outlines and fillColor the filled parts, e.g. strokeColor="#e5484d" fillColor="#ffd1d1"; both follow the text color by default.

## Related icons

- [Star](https://useanimations.com/icons/star) (click-toggle)
- [Thumb up](https://useanimations.com/icons/thumb-up) (click-toggle)
- [Plus/X](https://useanimations.com/icons/plus-to-x) (click-toggle)
- [Shield Off](https://useanimations.com/icons/shield-off) (click-toggle)
- [Search/X](https://useanimations.com/icons/search-to-x) (click-toggle)
- [Maxi/Minimize V2](https://useanimations.com/icons/maximize-minimize-v2) (click-toggle)
- [Settings V2](https://useanimations.com/icons/settings-v2) (click-toggle)
- [Maxi/Minimize](https://useanimations.com/icons/maximize-minimize) (click-toggle)
- [Lock / Unlock](https://useanimations.com/icons/lock) (click-toggle)
- [Visibility V2](https://useanimations.com/icons/visibility-v2) (click-toggle)
- [Visibility V3](https://useanimations.com/icons/visibility-v3) (click-toggle)
- [Bookmark](https://useanimations.com/icons/bookmark) (click-toggle)

[All action icons](https://useanimations.com/categories/action) · [All icons](https://useanimations.com/icons)