A browsable media library for Medusa v2. The File Module uploads to storage but keeps no record — this plugin is that record.
Authored by Billy Mahmood. Maintained by Hollowpoint. MIT licensed.
npm install @hollowpoint-io/medusa-plugin-media-library// medusa-config.ts
module.exports = defineConfig({
plugins: [
{
resolve: "@hollowpoint-io/medusa-plugin-media-library",
options: {},
},
],
})Then run migrations:
npx medusa db:migrateBuilt and tested against Medusa >=2.17 <3. File storage is whatever the host app already configured.
- Admin page Media Library — filter, upload (via Medusa's File Module), copy URL, edit alt/role
- Registry keyed uniquely by URL (re-registering is a no-op)
- Deleting a library row never deletes the stored file, so existing references keep working
| Method | Path | Notes |
|---|---|---|
GET |
/admin/media |
?role=&source=&limit=&offset= |
POST |
/admin/media |
{ assets: [{ url, filename, mime_type?, role?, source?, alt? }] } |
DELETE |
/admin/media/:id |
registry only |
source is theme | content | upload.
npm install
npm test
npm run build
npm run devNeed this installed and wired on a live Medusa store? Hollowpoint does Medusa migrations and plugin work.