Changelog

What is new in UploadCN, newest first. New components, docs tools and package releases.

New components and docs ship when the site deploys. Changes to @uploadcn/core, @uploadcn/react and @uploadcn/server ship as npm releases, and every package also has its own CHANGELOG.md on GitHub.

To update the packages:

npm install @uploadcn/core@latest @uploadcn/react@latest @uploadcn/server@latest

To update a component, add it again and review the diff:

npx shadcn@latest add @uploadcn/upload --overwrite

November 10, 2026

Packages 0.1.5

Paste to upload

Add paste and an upload component takes screenshots and copied files pasted with Ctrl+V or ⌘+V. It is opt-in, and one line turns it on for one component, any block, or the whole app.

  • New component: Upload Paste, a wrapper that adds paste to any block, animated ones included.
  • paste on Upload, on File Upload and on UploadConfigProvider.
  • Pasted files are validated like dropped files, clipboard images get a real name, and pastes into text fields are never intercepted.
  • Slot forms (Identity Verification, Document Checklist, Job Application) put a pasted file in the slot you are on, or the first empty one.
  • New hook: useDropzonePaste.

Provider config generator

The config generator writes the .env template, the CORS rules and the permissions for Amazon S3, Cloudflare R2, Tigris and Cloudinary, in each provider's own format, from your bucket name and origins.

Also

  • This changelog, and a dot in the sidebar next to pages that are new.
  • The header fits on small phones.

November 6, 2026

Packages 0.1.4

  • cloudinaryAdapter uploads large files in chunks of at least 5 MiB, which Cloudinary requires. Errors from Cloudinary now carry its own reason.
  • Folder Upload shows the real files inside the folder.
  • Example previews are centered, dark mode is softer, and the animated blocks are cleaner.

October 15, 2026

Packages 0.1.3

  • cloudinaryAdapter signs again before a signature turns one hour old, when an upload resumes and between the chunks of long uploads.
  • The upload path is now tested against live S3-compatible servers on every change.

October 14, 2026

Packages 0.1.2

  • Uploads restored after a page reload now finish on Tigris and MinIO. s3Storage decodes the XML character references those services send.

October 13, 2026

October 12, 2026

  • UploadCN is in the official shadcn registry directory. Components install with one command and no setup. See Registry.

October 9, 2026

Packages 0.1.1 and 0.1.0

  • 0.1.1: components render when no adapter is configured, log a setup hint once, and each upload fails with the same hint, so pages build before storage is set up.
  • 0.1.0: the first public release of UploadCN: the upload engine, React hooks and primitives, the upload route, and the registry of components and blocks.

On this page

Sponsor UploadCNPut your logo in front of developers choosing how their app uploads files.