Server Uploads with Vercel Blob

Navigate to the Project you'd like to add the blob store to. Select the Storage tab, then select the Connect Database button.

Under the Create New tab, select Blob and then the Continue button.

Use the name "Images" and select Create a new Blob store. Select the environments where you would like the read-write token to be included. You can also update the prefix of the Environment Variable in Advanced Options

Once created, you are taken to the Vercel Blob store page.

Since you created the Blob store in a project, we automatically created and added the following Environment Variable to the project for you.

• BLOB_READ_WRITE_TOKEN

To use this Environment Variable locally, we recommend pulling it with the Vercel CLI:

vercel env pull .env.development.local

This page will upload files to your server. The files will then be sent to Vercel Blob.

'use client';
 
import type { PutBlobResult } from '@vercel/blob';
import { useState, useRef } from 'react';
 
export default function AvatarUploadPage() {
  const inputFileRef = useRef<HTMLInputElement>(null);
  const [blob, setBlob] = useState<PutBlobResult | null>(null);
  return (
    <>
      <h1>Upload Your Avatar</h1>
 
      <form
        onSubmit={async (event) => {
          event.preventDefault();
 
          if (!inputFileRef.current?.files) {
            throw new Error('No file selected');
          }
 
          const file = inputFileRef.current.files[0];
 
          const response = await fetch(
            `/api/avatar/upload?filename=${file.name}`,
            {
              method: 'POST',
              body: file,
            },
          );
 
          const newBlob = (await response.json()) as PutBlobResult;
 
          setBlob(newBlob);
        }}
      >
        <input name="file" ref={inputFileRef} type="file" required />
        <button type="submit">Upload</button>
      </form>
      {blob && (
        <div>
          Blob url: <a href={blob.url}>{blob.url}</a>
        </div>
      )}
    </>
  );
}

This route forwards the file to Vercel Blob and returns the URL of the uploaded file to the browser.

import { put } from '@vercel/blob';
import { NextResponse } from 'next/server';
 
export async function POST(request: Request): Promise<NextResponse> {
  const { searchParams } = new URL(request.url);
  const filename = searchParams.get('filename');
 
  const blob = await put(filename, request.body, {
    access: 'public',
  });
 
  return NextResponse.json(blob);
}

Run your application locally and visit /avatar/upload to upload the file to your store. The browser will display the unique URL created for the file.

When your local website is served on http://localhost:3000, then the onUploadCompleted step won't succeed as Vercel Blob cannot contact your localhost. Instead, we recommend you run your local application through a tunneling service like ngrok, so you can experience the full Vercel Blob development flow locally.

• Go to the Vercel Project where you created the store
• Select the Storage tab and select your new store
• Paste the blob object URL returned in the previous step in the Blob URL input box in the Browser section and select Lookup
• The following blob object metadata will be displayed: file name, path, size, uploaded date, content type and HTTP headers
• You also have the option to download and delete the file from this page