Direct File Upload Capability In Datasette

Issue 82 Edition 2026-03-23 4 min read

General

Sources: 1 • Confidence: High • Updated: 2026-04-13 03:53

Key takeaways

The datasette-files plugin adds the ability to upload files directly into a Datasette instance.
datasette-files adds a new file_actions plugin hook.
datasette-files supports uploading multiple files at once through a UI that uses a documented JSON upload API.
datasette-files configures its columns using Datasette 1.0a26's column_types system.
datasette-files can import an uploaded CSV or TSV file into a table.

The datasette-files plugin adds the ability to upload files directly into a Datasette instance.
datasette-files 0.1a2 is an alpha release of the datasette-files plugin.

datasette-files supports uploading multiple files at once through a UI that uses a documented JSON upload API.
datasette-files generates thumbnails for uploaded image files and stores them in an internal datasette_files_thumbnails table.

datasette-files configures its columns using Datasette 1.0a26's column_types system.

What authentication/authorization and permission model governs who can upload files and trigger imports/actions?
What is the minimum required Datasette version (and compatibility matrix) for datasette-files 0.1a2, given its use of column_types?
Where are uploaded files stored (database blobs vs filesystem vs external object storage), and what size/retention limits exist?
How does CSV/TSV import handle schema inference, data typing, encoding, and error reporting?
What are the semantics and stability expectations of the file_actions hook (ordering, retries, idempotency, failure handling)?

Datasette may be moving toward more end user ingestion workflows, expanding use cases from read only publishing to lightweight data import and automation.
The new file_actions hook suggests an emerging plugin ecosystem around post upload processing, enabling integrations and derived data generation.
Tighter coupling to Datasette 1.0 pre release configuration primitives may indicate the platform is prioritizing the 1.0 line and encouraging early migration by plugin authors.

Clear authentication and authorization guidance for uploads and imports, plus documented permission controls and safe defaults.
Compatibility matrix and minimum Datasette version stated for datasette files 0.1a2, with stable APIs for column_types and file_actions.
Operational documentation and releases covering storage backend, size and retention limits, backup and migration impacts, plus import schema and error handling.

No robust permission model or security guidance emerges, leaving uploads and imports difficult to run safely in multi user or public deployments.
Breaking changes or unclear stability in file_actions or column_types across Datasette versions, causing frequent plugin or deployment incompatibilities.
Storage growth or performance issues from thumbnails and internal tables, plus unreliable CSV or TSV imports with poor typing and error reporting.