netlify-blobs

Store and retrieve files and binary assets using Netlify Blobs object storage.

Updated Jul 16, 2026
One-click install
npx skills add https://github.com/JamesMitofsky/tag-archive --skill netlify-blobs-jamesmitofsky
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: netlify-blobs
Source: https://github.com/JamesMitofsky/tag-archive/tree/main/.claude/skills/netlify-blobs
Command: npx skills add https://github.com/JamesMitofsky/tag-archive --skill netlify-blobs-jamesmitofsky

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @netlify/blobs, @netlify/vite-plugin.

What problem does it solve? Netlify applications need a zero-config way to store files and assets — user uploads, exported documents, cached binaries, generated images — without provisioning external object storage or wiring up S3 credentials. ## Core Features & Use Cases - Blob CRUD and Listing: Create, read, update, delete, and prefix-list blobs via getStore(), with typed retrieval (text, JSON, stream, blob, arrayBuffer) and metadata support. - Store Scoping and Consistency: Choose site-scoped stores that persist across deploys or deploy-scoped stores tied to a deploy lifecycle, and opt into strong consistency for read-your-writes scenarios. - Build-Time Uploads and CLI Inspection: Seed deploy-scoped stores by writing files to .netlify/blobs/deploy/ during the build, and inspect or repair blobs with netlify blobs:list/get/set/delete CLI commands. - Use Case: A Netlify Function accepts user image uploads, stores them in a site-scoped store with content-type metadata, and serves them back through an authenticated endpoint that gates access. ## Quick Start Ask the AI to add Netlify Blobs storage to your Netlify function so it can save and serve uploaded files.

Frequently Asked Questions about netlify-blobs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I store files in Netlify Functions?

Use Netlify Blobs by installing @netlify/blobs and calling getStore() inside your function. The store provides set, get, delete, and list methods for string, JSON, or binary data with no provisioning required.

What is the difference between getStore and getDeployStore in Netlify Blobs?

getStore() creates a site-scoped store that persists across all deploys and is shared by production and previews. getDeployStore() is tied to a single deploy and is replaced when that deploy is replaced, suiting per-deploy build artifacts.

Can I use Netlify Blobs as a database for user data?

No. Netlify Blobs is object storage for files and assets, not queryable records. It has no transactions and concurrent writes are last-write-wins, so use Netlify Database for dynamic data, counters, or application state.

Why does my Netlify Blobs read return stale data after a write?

Blobs are eventually consistent by default, so an immediate read after a write may return the old value or null. Pass consistency: 'strong' to getStore() or to an individual get() call when you need read-your-writes.

How do I fix the error 'The environment has not been configured to use Netlify Blobs'?

This error appears in local development when Blobs access is not wired up. Install @netlify/vite-plugin for Vite-based projects, or run your project through netlify dev, which provides a sandboxed local store.

What are the size limits for Netlify Blobs?

Individual objects can be up to 5 GB, metadata is capped at 2 KB per object, store names are limited to 64 bytes, and keys to 600 bytes. Store large JSON payloads in the blob value itself rather than in metadata.