⚠️ Breaking Change
Impact Score: 7/10
Medusa v1.9.0 — Release Notes & Engineering Impact
Source available — automated, not human-reviewed
Component: medusajs · Channel: stable. Automated analysis, not a compatibility certification. How this works.
Analysis updated: 2026-11-01.
Breaking-change evidence from the source
Breaking changes A minor breaking change has been introduced to the events system. The `EventBusModule` interface has been updated with a [new method, `retrieveSubscribers`](https://github.com/medusajs/medusa/blob/7e5df1307266a7ded6cf777bc12db6b32f66efd7/packages/types/src/event-bus/event-bus-module.ts#L9). The method is used in the core `EventBusService` to fetch subscribers to a given event upon emitting one or multiple events. If no subscribers exist to an event, we do not insert a staged job in the database which means the event will not be sent for processing in the event bus module.
A minor breaking change has been introduced to the events system. The `EventBusModule` interface has been updated with a [new method, `retrieveSubscribers`](https://github.com/medusajs/medusa/blob/7e5df1307266a7ded6cf777bc12db6b32f66efd7/packages/types/src/event-bus/event-bus-module.ts#L9). The method is used in the core `EventBusService` to fetch subscribers to a given event upon emitting one or multiple events. If no subscribers exist to an event, we do not insert a staged job in the database which means the event will not be sent for processing in the event bus module.
⚡ Executive Summary (TL;DR)
Medusa v1.9.0. Source highlight: A minor breaking change has been introduced to the events system. The `EventBusModule` interface has been updated with a new method, `retrieveSubscribers`. The method is used in the core `EventBusService` to fetch subscribers to a given event upon emitting one or multiple events. If no subscribers e
Who Does This Impact? (Role-Based Analysis)
💻 Software Engineers & Devs
Check the source notes against the package and APIs you use before upgrading.
📊 Product & Engineering Leads
Use the documented changes to assess relevance to your product; release frequency alone is not a quality measure.
⚙️ DevOps & Security
Verify the target version, runtime requirements and rollback procedure in the official documentation.
⚠️ Breaking Changes & Deprecations (2)
- Breaking changes A minor breaking change has been introduced to the events system. The `EventBusModule` interface has been updated with a [new method, `retrieveSubscribers`](https://github.com/medusajs/medusa/blob/7e5df1307266a7ded6cf777bc12db6b32f66efd7/packages/types/src/event-bus/event-bus-module.ts#L9). The method is used in the core `EventBusService` to fetch subscribers to a given event upon emitting one or multiple events. If no subscribers exist to an event, we do not insert a staged job in the database which means the event will not be sent for processing in the event bus module.
- A minor breaking change has been introduced to the events system. The `EventBusModule` interface has been updated with a [new method, `retrieveSubscribers`](https://github.com/medusajs/medusa/blob/7e5df1307266a7ded6cf777bc12db6b32f66efd7/packages/types/src/event-bus/event-bus-module.ts#L9). The method is used in the core `EventBusService` to fetch subscribers to a given event upon emitting one or multiple events. If no subscribers exist to an event, we do not insert a staged job in the database which means the event will not be sent for processing in the event bus module.
✨ New Features & Capabilities (6)
- feat(medusa): Add purchasable prop on variants when setting availability
- feat(admin-ui): Implement allocations on draft orders
- feat(medusa-file-s3,medusa-file-minio): Upgrade to TypeScript
- feat(medusa, medusa-plugin-brightpearl): Inventory management for Brightpearl
- feat(medusa-plugin-meilisearch): Update meilisearch library dependency
- feat(admin-ui): Add Sales Channel filter by @olivermrbl in https://github.com/medusajs/medusa/pull/3897
🔧 Bug Fixes & Patches (6)
- fix(admin-ui): password reset flip rendering condition
- fix(inventory): Add missing context arguments
- fix(medusa): Add missing relations when creating return
- fix(medusa): Bulk create variant + pass transaction to the inventory service context methods
- fix(medusa): Correct inventory quantity calculation
- fix(medusa-plugin-ip-lookup): Remove outdated Typeorm usage
📄 View Raw Release Notes (Original Developer Log)
<!--
# Version 1.9.0
This version improves filtering capabilities on Orders in Medusa Admin, allowing merchants to easily manage Orders across Sales Channels.
CMS_BREAK -->
### Breaking changes
A minor breaking change has been introduced to the events system. The `EventBusModule` interface has been updated with a [new method, `retrieveSubscribers`](https://github.com/medusajs/medusa/blob/7e5df1307266a7ded6cf777bc12db6b32f66efd7/packages/types/src/event-bus/event-bus-module.ts#L9). The method is used in the core `EventBusService` to fetch subscribers to a given event upon emitting one or multiple events. If no subscribers exist to an event, we do not insert a staged job in the database which means the event will not be sent for processing in the event bus module.
### Features
* feat(medusa): Add purchasable prop on variants when setting availability by @pKorsholm in https://github.com/medusajs/medusa/pull/3811
* feat(admin-ui): Implement allocations on draft orders by @StephixOne in https://github.com/medusajs/medusa/pull/3753
* feat(medusa-file-s3,medusa-file-minio): Upgrade to TypeScript by @dwene in https://github.com/medusajs/medusa/pull/3740
* feat(medusa, medusa-plugin-brightpearl): Inventory management for Brightpearl by @pKorsholm in https://github.com/medusajs/medusa/pull/3192
* feat(medusa-plugin-meilisearch): Update meilisearch library dependency by @pevey in https://github.com/medusajs/medusa/pull/3898
* feat(admin-ui): Add Sales Channel filter by @olivermrbl in https://github.com/medusajs/medusa/pull/3897
* feat(medusa): Middleware to add default SC on query if no SC already exist on it by @StephixOne in https://github.com/medusajs/medusa/pull/3694
### Bugs
* fix(admin-ui): password reset flip rendering condition by @nowseemee in https://github.com/medusajs/medusa/pull/3864
* fix(inventory): Add missing context arguments by @olivermrbl in https://github.com/medusajs/medusa/pull/3863
* fix(medusa): Add missing relations when creating return by @olivermrbl in https://github.com/medusajs/medusa/pull/3870
* fix(medusa): Bulk create variant + pass transaction to the inventory service context methods by @adrien2p in https://github.com/medusajs/medusa/pull/3835
* fix(medusa): Correct inventory quantity calculation by @pKorsholm in https://github.com/medusajs/medusa/pull/3881
* fix(medusa-plugin-ip-lookup): Remove outdated Typeorm usage by @olivermrbl in https://github.com/medusajs/medusa/pull/3884
* fix(admin-ui): Check for undefined categories by @olivermrbl in https://github.com/medusajs/medusa/pull/3886
* fix(inventory): Minor fixes to upserting inventory items by @olivermrbl in https://github.com/medusajs/medusa/pull/3883
* fix(medusa,medusa-fulfillment-webshipper): Add default values in Webshipper service by @olivermrbl in https://github.com/medusajs/medusa/pull/3879
* fix(admin-ui): Add guard for null `product_id` by @pKorsholm in https://github.com/medusajs/medusa/pull/3894
* fix(medusa,utils): Searching indexing product subscriber by @olivermrbl in https://github.com/medusajs/medusa/pull/3905
* fix(admin): display correct items in the timeline after OE by @fPolic in https://github.com/medusajs/medusa/pull/3895
* fix(medusa): category list api bug where limit skews results by @riqwan in https://github.com/medusajs/medusa/pull/3914
* fix(medusa): Reduce joins in cart retrieval by @olivermrbl in https://github.com/medusajs/medusa/pull/3909
### Chores
* chore: Bump package versions to address security vulnerabilities by @pevey in https://github.com/medusajs/medusa/pull/3845
### New Contributors
* @nowseemee made their first contribution in https://github.com/medusajs/medusa/pull/3864
**Full Changelog**: https://github.com/medusajs/medusa/compare/v1.8.2...v1.9.0