⚠️ Breaking Change
Impact Score: 7/10
Medusa v2.0.4 — 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 change: If you have created data models using the uncountable nouns and special rules below, you might be affected.
breaking: pluralize type helper to account for uncountable nouns and special rules by @thetutlage in https://github.com/medusajs/medusa/pull/10011
⚡ Executive Summary (TL;DR)
Medusa v2.0.4. Source highlight: Improved pluralization of `MedusaService` types
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 change: If you have created data models using the uncountable nouns and special rules below, you might be affected.
- breaking: pluralize type helper to account for uncountable nouns and special rules by @thetutlage in https://github.com/medusajs/medusa/pull/10011
✨ New Features & Capabilities (1)
- docs: add changeset for #10011
⚡ Performance & Enhancements (4)
- First, it checks for uncountable nouns in a dictionary.
- Second, it looks for special rules for certain words like tooth, man, etc.
- docs: improve transform docs
- docs: improve getting started chapters
🔧 Bug Fixes & Patches (6)
- breaking: pluralize type helper to account for uncountable nouns and special rules
- fix(types): Add AdminBatchUpdateProductVariant type
- fix(medusa, types): filter product by external_id
- fix(dashboard): handle deleted products/variants in the order domain
- fix(dashboard): Load product variant edit page and fix product detail query key
- docs: fix link to testing tools
📄 View Raw Release Notes (Original Developer Log)
<!--
# v2.0.4
This version improves the type generation in the service factory and resolves a range of minor bugs reported since 2.0.0.
CMS_BREAK -->
## Highlights
### Improved pluralization of `MedusaService` types
> [!WARNING]
Breaking change: If you have created data models using the uncountable nouns and special rules below, you might be affected.
We've updated the type helper used to generate types for the methods of the `MedusaService`. It now has two conditional checks when converting a singular value to a plural value at the types level.
- First, it checks for uncountable nouns in a dictionary.
- Second, it looks for special rules for certain words like tooth, man, etc.
You can find the reference of uncountable nouns and special rules [here](https://github.com/medusajs/medusa/blob/713e428ec297aa9b23727673e64ca3505c5f5221/packages/core/types/src/common/common.ts#L246).
## Bugs
* breaking: pluralize type helper to account for uncountable nouns and special rules by @thetutlage in https://github.com/medusajs/medusa/pull/10011
* fix(types): Add AdminBatchUpdateProductVariant type by @kasperkristensen in https://github.com/medusajs/medusa/pull/10009
* fix(medusa, types): filter product by external_id by @fPolic in https://github.com/medusajs/medusa/pull/10010
* fix(dashboard): handle deleted products/variants in the order domain by @fPolic in https://github.com/medusajs/medusa/pull/9841
* fix(dashboard): Load product variant edit page and fix product detail query key by @kasperkristensen in https://github.com/medusajs/medusa/pull/10029
### Documentation
* docs: improve transform docs by @shahednasser in https://github.com/medusajs/medusa/pull/10023
* docs: fix link to testing tools by @shahednasser in https://github.com/medusajs/medusa/pull/10030
* docs: improve getting started chapters by @shahednasser in https://github.com/medusajs/medusa/pull/10014
* docs: fix cart completion in subscriptions recipe by @shahednasser in https://github.com/medusajs/medusa/pull/10021
## Chores
* chore(medusa): show success message after user is created by @shahednasser in https://github.com/medusajs/medusa/pull/10027
## Other Changes
* docs: add changeset for #10011 by @thetutlage in https://github.com/medusajs/medusa/pull/10018
**Full Changelog**: https://github.com/medusajs/medusa/compare/v2.0.3...v2.0.4