@hollowpoint-io/medusa-plugin-media-library

Browsable media library over Medusa v2's File Module. Registry-only deletes.


Keywords
medusa, plugin, medusa-plugin-other, medusa-plugin, medusa-v2, media, media-library
License
MIT
Install
npm install @hollowpoint-io/medusa-plugin-media-library@0.1.0

Documentation

@hollowpoint-io/medusa-plugin-media-library

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.

Install

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:migrate

Built and tested against Medusa >=2.17 <3. File storage is whatever the host app already configured.

What you get

  • 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

API

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.

Develop

npm install
npm test
npm run build
npm run dev

Need this installed and wired on a live Medusa store? Hollowpoint does Medusa migrations and plugin work.