Start freeDashboard

Upload widget for developers · Open source · Free tier

Let users upload from their phone into your web form.

CrossUpload puts a QR code next to the file input on your website. Your user scans it, picks a photo or document on the phone, and the file appears in the form on their computer, type-checked, virus-scanned and handed to your backend as a file ID. You add one script tag and one API call.

Start free Self-host it (open source) Read the docs

Free plan: 100 accepted uploads a month, no card. Or run the open-source core on your own server with npm install.

20 seconds: Maya uploads her ID from her phone, the long way round through a chat app, then with CrossUpload. Turn the sound on for the music.

It lands in your form.

One script tag in the page, one API call from your backend. We host the phone page, store and scan the file, and hand your form a verified file ID.

Your backend decides what is allowed: file types, size and count, per project or per session through the API.

See it in action

One short video: what your users do, the code you add, and how your backend stays in control of what gets uploaded.

CrossUpload in 35 seconds, with music: what your users do, the code you add, and the rules your backend sets.

Try the live demo yourself

From six steps to two

Without a phone option, users have to move the file to the computer first and then find it again. With CrossUpload they scan the QR code and send it straight to your form.

Without CrossUpload

  1. 1Open a messenger or email on the phone
  2. 2Send the photo to yourself
  3. 3Open the chat on the computer
  4. 4Download the (compressed) file
  5. 5Find it in the Downloads folder
  6. 6Upload it to the form

With CrossUpload

  1. 1Scan the QR code with the phone camera
  2. 2Pick the file and tap Send

The user continues and submits as usual.
Why this works

Built for developers. Add it in three steps.

  1. 1

    Create a project

    Sign up, add your site’s origin and create a server API key. Set the project’s default file types and size limits.

  2. 2

    Add a session endpoint

    Your backend calls POST /v1/sessions with its secret key. Pass allowedTypes, maxFileSize and maxFiles to decide, form by form, what users may send.

  3. 3

    Attach the widget

    One script tag and CrossUpload.attach() on your existing button. Accepted file IDs land in a hidden field.

<button type="button" id="upload">Upload a file</button><input type="hidden" id="attachments" name="attachment_ids" value="[]"><script src="https://app.crossupload.com/v1/widget.js"></script><script>  CrossUpload.attach({    target: '#upload',    mode: 'picker',    sessionEndpoint: '/api/crossupload/session',    resultInput: '#attachments',    maxFiles: 3,    onComplete({ files }) { console.log(files); }  });</script>
CrossUpload.attach({  target: '#upload',  mode: 'picker',  sessionEndpoint:    '/api/crossupload/session',  resultInput: '#attachments',  maxFiles: 3,  onComplete({ files }) {    console.log(files);  }});

Read the quickstart

Made for forms that ask for documents

Security is the default, not an add-on

Files upload straight to private quarantine storage with short-lived, narrowly scoped credentials. A background worker checks the real file type, scans it with ClamAV, and promotes the exact verified version to an immutable delivery copy. Only then does your form see it.

How we protect uploads

  • Single-use, expiring QR pairing
  • Separate credentials for server, desktop and phone
  • HTML, SVG and executables rejected by default
  • Private files: your backend downloads with its key
  • Signed webhooks with retries

Open source. Run it on your own server.

The core of CrossUpload, the widget, the QR pairing, the phone page, live delivery to the desktop and file-type checks, is open source under the MIT license. Clone it, run npm install and it works on your machine. Prefer not to run servers? The hosted service adds virus scanning, private S3 storage, webhooks, a dashboard and a free tier.

git clone https://github.com/uurtech/crossuploadjs.git
cd crossuploadjs
npm install
npm start          # http://localhost:4000

Get the code on GitHub

Simple pricing. Only accepted files count.

Opening the picker, scanning a QR code, retries and rejected files are free.

Compare plans in detail

Give your users the shortcut. Ship it this afternoon.

The Free plan includes 100 accepted uploads a month, no card needed. Questions? Write to cloud@crossupload.com.

Create a free account

See how it works