# @wordpress/blob

> Blob utilities for WordPress.

Latest version **4.55.0** (published 2026-09-10) · GPL-2.0-or-later license · 0 weekly downloads

## Install

```sh
npm install @wordpress/blob
pnpm add @wordpress/blob
yarn add @wordpress/blob
bun add @wordpress/blob
```

## Health

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

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

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 4.55.0 |
| Published | 2026-09-10 |
| First published | 2018-05-30 |
| Weekly downloads | 0 |
| License | GPL-2.0-or-later |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=18.12.0 |
| Dependencies | 0 |
| Unpacked size | 57.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 11748 |
| Author | The WordPress Contributors |
| Maintainers | garypendergast, adamsilverstein, gziolo, ntwb, riad, noisysocks, kadamwhite, gutenbergplugin, jorgefilipecosta, ellatrix, iandunn206, whyisjake, ockham, sirreal, nosolosw, wpisabel, ntsekouras, nerrad, desrosj, talldanwp, peterwilsoncc, ryanwelcher, mamaduka, aduth, johnbillion |
| Keywords | wordpress, gutenberg, blob |

## Links

- npm: https://www.npmjs.com/package/@wordpress/blob
- Repository: https://github.com/WordPress/gutenberg
- Homepage: https://github.com/WordPress/gutenberg/tree/HEAD/packages/blob/README.md
- Issues: https://github.com/WordPress/gutenberg/issues
- npm.io page: https://npm.io/package/@wordpress/blob

## Recent versions

- 4.55.0 (latest) — 2026-09-10
- 4.54.1-next.v.202609031004.0 (next) — 2026-09-03
- 4.40.1 (wp-7.0) — 2026-06-30
- 4.33.1 (wp-6.9) — 2025-10-28
- 4.19.1 (wp-6.8) — 2025-03-10
- 4.8.1 (wp-6.7) — 2024-09-19
- 4.0.1 (wp-6.6) — 2024-06-11
- 3.51.1 (wp-6.5) — 2024-02-20
- 3.42.13 (wp-6.4) — 2023-11-13
- 3.35.2 (wp-6.3) — 2023-10-12
- 3.26.2 (wp-6.2) — 2023-10-12
- 3.17.1 (wp-6.1) — 2022-09-20
- 3.6.1 (wp-6.0) — 2022-04-19
- 3.2.2 (wp-5.9) — 2021-11-15
- 3.1.2 (wp-5.8) — 2021-09-01
- … 231 more at https://npm.io/package/@wordpress/blob/versions

## README

# Blob

Blob utilities for WordPress.

## Installation

Install the module

```bash
npm install @wordpress/blob --save
```

## API

<!-- START TOKEN(Autogenerated API docs) -->

### createBlobURL

Create a blob URL from a file.

_Parameters_

-   _file_ `File`: The file to create a blob URL for.

_Returns_

-   `string`: The blob URL.

### downloadBlob

Downloads a file, e.g., a text or readable stream, in the browser. Appropriate for downloading smaller file sizes, e.g., \< 5 MB.

Example usage:

```js
const fileContent = JSON.stringify(
	{
		title: 'My Post',
	},
	null,
	2
);
const filename = 'file.json';

downloadBlob( filename, fileContent, 'application/json' );
```

_Parameters_

-   _filename_ `string`: File name.
-   _content_ `BlobPart`: File content (BufferSource | Blob | string).
-   _contentType_ `string`: (Optional) File mime type. Default is `''`.

### getBlobByURL

Retrieve a file based on a blob URL. The file must have been created by `createBlobURL` and not removed by `revokeBlobURL`, otherwise it will return `undefined`.

_Parameters_

-   _url_ `string`: The blob URL.

_Returns_

-   `File | undefined`: The file for the blob URL.

### getBlobTypeByURL

Retrieve a blob type based on URL. The file must have been created by `createBlobURL` and not removed by `revokeBlobURL`, otherwise it will return `undefined`.

_Parameters_

-   _url_ `string`: The blob URL.

_Returns_

-   `string | undefined`: The blob type.

### isBlobURL

Check whether a url is a blob url.

_Parameters_

-   _url_ `string | undefined`: The URL.

_Returns_

-   `boolean`: Is the url a blob url?

### revokeBlobURL

Remove the resource and file cache from memory.

_Parameters_

-   _url_ `string`: The blob URL.

<!-- END TOKEN(Autogenerated API docs) -->

## Contributing to this package

This is an individual package that's part of the Gutenberg project. The project is organized as a monorepo. It's made up of multiple self-contained software packages, each with a specific purpose. The packages in this monorepo are published to [npm](https://www.npmjs.com/) and used by [WordPress](https://make.wordpress.org/core/) as well as other software projects.

To find out more about contributing to this package or Gutenberg as a whole, please read the project's main [contributor guide](https://github.com/WordPress/gutenberg/tree/HEAD/CONTRIBUTING.md).

<br /><br /><p align="center"><img src="https://s.w.org/style/images/codeispoetry.png?1" alt="Code is Poetry." /></p>

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