# @atlaskit/editor-plugin-image-upload

> Image upload plugin for @atlaskit/editor-core

Latest version **33.0.0** (published 2026-11-17) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @atlaskit/editor-plugin-image-upload
pnpm add @atlaskit/editor-plugin-image-upload
yarn add @atlaskit/editor-plugin-image-upload
bun add @atlaskit/editor-plugin-image-upload
```

## Health

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

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

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 33.0.0 |
| Published | 2026-11-17 |
| First published | 2023-08-15 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 3 |
| Unpacked size | 65.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Atlassian Pty Ltd |
| Maintainers | atlassianartifactteam |

## Links

- npm: https://www.npmjs.com/package/@atlaskit/editor-plugin-image-upload
- Repository: https://bitbucket.org/atlassian/atlassian-frontend-mirror
- Homepage: https://bitbucket.org/atlassian/atlassian-frontend-mirror#readme
- Issues: https://bitbucket.org/atlassian/atlassian-frontend-mirror/issues
- npm.io page: https://npm.io/package/@atlaskit/editor-plugin-image-upload

## Dependencies (3)

- [@babel/runtime](https://npm.io/package/@babel/runtime.md) ^7.0.0
- [@atlaskit/editor-prosemirror](https://npm.io/package/@atlaskit/editor-prosemirror.md) ^9.0.0
- [@atlaskit/prosemirror-input-rules](https://npm.io/package/@atlaskit/prosemirror-input-rules.md) ^4.1.0

## Recent versions

- 33.0.0 (latest) — 2026-11-17
- 32.0.0 — 2026-11-17
- 31.0.0 — 2026-11-16
- 30.0.0 — 2026-10-27
- 29.0.0 — 2026-10-20
- 28.0.0 — 2026-10-16
- 27.0.0 — 2026-10-13
- 26.0.0 — 2026-10-08
- 25.0.0 — 2026-10-07
- 24.0.0 — 2026-10-02
- 23.0.0 — 2026-10-01
- 22.0.0 — 2026-09-25
- 21.0.0 — 2026-09-24
- 20.0.0 — 2026-09-23
- 19.0.0 — 2026-09-17
- … 75 more at https://npm.io/package/@atlaskit/editor-plugin-image-upload/versions

## README

# Editor Plugin Image Upload

Image upload plugin for @atlaskit/editor-core

**Note:** This component is designed for internal Atlassian development.
External contributors will be able to use this component but will not be able to submit issues.

## Overview

The Image Upload plugin provides image upload capabilities for the Atlassian Editor. It integrates with `@atlaskit/editor-core` to handle image insertion through multiple input methods and manages the upload workflow.

## Key features

- **Drag-and-drop upload** - Drag images directly into the editor
- **Clipboard paste** - Paste images from clipboard with intelligent MS Office screenshot detection
- **Markdown image syntax** - Convert markdown image syntax `![alt](url)` to media nodes
- **Upload handler integration** - Configurable upload handlers for custom image processing
- **Plugin state management** - Track upload state with enabled, active, and hidden states

## Install
---
- **Install** - *yarn add @atlaskit/editor-plugin-image-upload*
- **npm** - [@atlaskit/editor-plugin-image-upload](https://www.npmjs.com/package/@atlaskit/editor-plugin-image-upload)
- **Source** - [Bitbucket](https://bitbucket.org/atlassian/atlassian-frontend/src/master/packages/editor/editor-plugin-image-upload)
- **Bundle** - [unpkg.com](https://unpkg.com/@atlaskit/editor-plugin-image-upload/dist/)

## Usage
---
**Internal use only**

@atlaskit/editor-plugin-image-upload is intended for internal use by the @atlaskit/editor-core and as a plugin dependency of the Editor within your product.

Direct use of this component is not supported.

Please see [Atlaskit - Editor plugin image upload](https://atlaskit.atlassian.com/packages/editor/editor-plugin-image-upload) for documentation and examples for this package.

## Support
---
For internal Atlassian, visit the slack channel [#help-editor](https://atlassian.slack.com/archives/CFG3PSQ9E) for support or visit [go/editor-help](https://go/editor-help) to submit a bug.

## License
---
Please see [Atlassian Frontend - License](https://hello.atlassian.net/wiki/spaces/AF/pages/2589099144/Documentation#License) for more licensing information.

---
_Source: https://npm.io/package/@atlaskit/editor-plugin-image-upload · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
