# @uppy/facebook

> Import files from Facebook, into Uppy.

Latest version **6.0.0** (published 2026-08-26) · MIT license · 0 weekly downloads

## Install

```sh
npm install @uppy/facebook
pnpm add @uppy/facebook
yarn add @uppy/facebook
bun add @uppy/facebook
```

## Health

**Score 65/100 (B)** — status: active.

Positive: esm support; no vulnerabilities; recently updated; high maintenance score; popular repo.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 6.0.0 |
| Published | 2026-08-26 |
| First published | 2019-10-09 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Dependencies | 1 |
| Unpacked size | 22.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 30975 |
| Maintainers | kvz, tim-kos, mifi, uppydev |
| Keywords | file uploader, uppy, uppy-plugin, facebook |

## Links

- npm: https://www.npmjs.com/package/@uppy/facebook
- Repository: https://github.com/transloadit/uppy
- Homepage: https://uppy.io
- Issues: https://github.com/transloadit/uppy/issues
- npm.io page: https://npm.io/package/@uppy/facebook

## Dependencies (1)

- [preact](https://npm.io/package/preact.md) ^10.29.2

## Recent versions

- 6.0.0 (latest) — 2026-08-26
- 4.0.0-beta.7 (next) — 2024-06-27
- 5.1.0 — 2025-12-02
- 5.0.1 — 2025-09-16
- 5.0.0 — 2025-08-22
- 4.3.2 — 2025-08-01
- 4.3.1 — 2025-07-29
- 4.3.0 — 2025-07-29
- 4.2.3 — 2025-05-18
- 4.2.2 — 2025-04-08
- 4.2.1 — 2025-01-09
- 4.2.0 — 2025-01-06
- 4.1.2 — 2024-12-05
- 4.1.1 — 2024-10-31
- 4.1.0 — 2024-08-29
- … 68 more at https://npm.io/package/@uppy/facebook/versions

## README

# @uppy/facebook

<img src="https://uppy.io/img/logo.svg" width="120" alt="Uppy logo: a smiling puppy above a pink upwards arrow" align="right">

[![npm version](https://img.shields.io/npm/v/@uppy/facebook.svg?style=flat-square)](https://www.npmjs.com/package/@uppy/facebook)
![CI status for Uppy tests](https://github.com/transloadit/uppy/workflows/CI/badge.svg)
![CI status for Companion tests](https://github.com/transloadit/uppy/workflows/Companion/badge.svg)
![CI status for browser tests](https://github.com/transloadit/uppy/workflows/End-to-end%20tests/badge.svg)

The Facebook plugin for Uppy lets users import files from their Facebook
account.

A Companion instance is required for the Facebook plugin to work. Companion
handles authentication with Facebook, downloads files from Facebook and uploads
them to the destination. This saves the user bandwidth, especially helpful if
they are on a mobile connection.

Uppy is being developed by the folks at [Transloadit](https://transloadit.com),
a versatile file encoding service.

## Example

```js
import Uppy from '@uppy/core'
import Facebook from '@uppy/facebook'

const uppy = new Uppy()
uppy.use(Facebook, {
  // Options
})
```

## Installation

```bash
$ npm install @uppy/facebook
```

Alternatively, you can also use this plugin in a pre-built bundle from
Transloadit’s CDN: Smart CDN. In that case `Uppy` will attach itself to the
global `window.Uppy` object. See the
[main Uppy documentation](https://uppy.io/docs/#Installation) for instructions.

## Documentation

Documentation for this plugin can be found on the
[Uppy website](https://uppy.io/docs/facebook).

## License

[The MIT License](./LICENSE).

---
_Source: https://npm.io/package/@uppy/facebook · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._