Impact Score: 5/10
Medusa v1.12.2 โ 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.
โก Executive Summary (TL;DR)
Medusa v1.12.2. Source highlight: Simplified entity extensions
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.
โจ New Features & Capabilities (6)
- feat(create-medusa-app): support admin onboarding experience
- feat(medusa-plugin-sendgrid): Add error messages
- feat(medusa): Allow to register extended validators seemlesly
- feat(medusa): Improve error messaging in plugin loader
- feat(medusa-react,medusa-js): Allow custom headers
- feat(medusa, types): Improve DX of model extensions (#4398)
๐ง Bug Fixes & Patches (3)
- fix(product, types): correct path for migration files + fix types on products service module
- fix(medusa, utils): fix the way selects are consumed alongside the relations
- fix(medusa-react): fix wrong admin reservations query key
๐ View Raw Release Notes (Original Developer Log)
<!--

# Version 1.12.2
This version improves the developer experience of customizations and extends payment plugins with update capabilities.
CMS_BREAK -->
## Highlights
### Simplified entity extensions
We've simplified the steps to extend an entity so you no longer need to 1) override the entity's repository ([step 4 from our guide](https://docs.medusajs.com/development/entities/extend-entity#step-4-extend-repository)) and 2) override the models in a custom entry point file.
Our documentation on [Extending an Entity](https://docs.medusajs.com/development/entities/extend-entity) has been updated to reflect these changes.
### Simplified validator extensions
We've simplified the steps to extend the API payload validation so you no longer have to create a util to perform an override and include it in a loader.
Our documentation will be updated very soon to reflect these changes.
To extend a validator, import and use a new util `registerOverriddenValidators`.
```ts
import { registerOverriddenValidators } from "@medusajs/medusa"
import { AdminPostProductsReq as MedusaAdminPostProductsReq } from "@medusajs/medusa/dist/api/routes/admin/products/create-product"
import { IsString } from "class-validator"
class AdminPostProductsReq extends MedusaAdminPostProductsReq {
@IsString()
test: string
}
registerOverriddenValidators(AdminPostProductsReq)
```
## Features
* feat(create-medusa-app): support admin onboarding experience by @shahednasser in https://github.com/medusajs/medusa/pull/4339
* feat(medusa-plugin-sendgrid): Add error messages by @pevey in https://github.com/medusajs/medusa/pull/4384
* feat(medusa): Allow to register extended validators seemlesly by @adrien2p in https://github.com/medusajs/medusa/pull/4397
* feat(medusa): Improve error messaging in plugin loader by @olivermrbl in https://github.com/medusajs/medusa/pull/4410
* feat(medusa-react,medusa-js): Allow custom headers by @pevey in https://github.com/medusajs/medusa/pull/4409
* feat(medusa, types): Improve DX of model extensions (#4398) by @riqwan in https://github.com/medusajs/medusa/pull/4398
* feat: Remote Joiner by @carlos-r-l-rodrigues in https://github.com/medusajs/medusa/pull/4098
* feat(medusa, stripe, paypal): Add update payment session support to the abstract payment processor API by @adrien2p in #4442
* feat(create-medusa-app): remove .git directory in the project by @shahednasser in #4493
## Bugs
* fix(product, types): correct path for migration files + fix types on products service module by @riqwan in https://github.com/medusajs/medusa/pull/4348
* fix(medusa, utils): fix the way selects are consumed alongside the relations by @adrien2p in https://github.com/medusajs/medusa/pull/4389
* fix(medusa-react): fix wrong admin reservations query key by @josetr in https://github.com/medusajs/medusa/pull/4441
## Chores
* chore(medusa): Concurrently get the items and count instead of sequentially by @adrien2p in https://github.com/medusajs/medusa/pull/4367
* chore(gatsby-source-medusa): Cleanup plugin setup by @adrien2p in https://github.com/medusajs/medusa/pull/4419
* chore(medusa-dev-cli): Cleanup plugin setup by @adrien2p in https://github.com/medusajs/medusa/pull/4421
* chore(medusa-cli): Cleanup plugin setup by @adrien2p in https://github.com/medusajs/medusa/pull/4420
* chore(create-medusa-app): Cleanup the main script for readability and maintainability by @adrien2p in #4369
**Full Changelog**: https://github.com/medusajs/medusa/compare/v1.12.1...v1.12.2