# @uppy/url

> The Url plugin lets users import files from the Internet. Paste any URL and it’ll be added!

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

## Install

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

## Health

**Score 80/100 (A)** — status: active.

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

Warnings: no types.

## Facts

| | |
|---|---|
| Version | 6.0.0 |
| Published | 2026-08-26 |
| First published | 2018-06-28 |
| Weekly downloads | 185.8K |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Dependencies | 2 |
| Unpacked size | 46.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 30969 |
| Maintainers | kvz, tim-kos, mifi, uppydev |
| Keywords | file uploader, url, import from url, uppy, uppy-plugin |

## Links

- npm: https://www.npmjs.com/package/@uppy/url
- 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/url

## Dependencies (2)

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

## Alternatives

- [base64url](https://npm.io/package/base64url.md) — 6.1M weekly downloads
- [get-installed-path](https://npm.io/package/get-installed-path.md) — 502.9K weekly downloads
- [@d3fc/d3fc-shape](https://npm.io/package/@d3fc/d3fc-shape.md) — 16.2K weekly downloads
- [localizer](https://npm.io/package/localizer.md) — 226 weekly downloads
- [tg-resolve](https://npm.io/package/tg-resolve.md) — 176 weekly downloads

## Recent versions

- 6.0.0 (latest) — 2026-08-26
- 4.0.0-beta.8 (next) — 2024-06-27
- 5.1.0 — 2025-12-02
- 5.0.2 — 2025-10-17
- 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.4 — 2025-05-18
- 4.2.3 — 2025-04-08
- 4.2.2 — 2025-02-03
- 4.2.1 — 2025-01-09
- 4.2.0 — 2025-01-06
- 4.1.3 — 2025-01-06
- … 93 more at https://npm.io/package/@uppy/url/versions

## README

# @uppy/url

<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/url.svg?style=flat-square)](https://www.npmjs.com/package/@uppy/url)
![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 Url plugin lets users import files from the Internet. Paste any URL and
it’ll be added!

A Companion instance is required for the Url plugin to work. Companion will
download the files and upload them to their destination. This saves bandwidth
for the user (especially on mobile connections) and helps avoid CORS
restrictions.

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 Url from '@uppy/url'

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

## Installation

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

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/url).

## License

[The MIT License](./LICENSE).

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