Impact Score: 5/10
v2.8.7: Improved `create-medusa-app` and corrected tax calculations
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 v2.8.7. Source highlight: New `--version` flag for `create-medusa-app`
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 (1)
- feat(create-medusa-app): Allow to create project with specific medusa version
๐ง Bug Fixes & Patches (6)
- fix(core-flows): Locations levels check in draft order and order edit flows
- fix(index): merge filterable fields schema
- fix(): Order constraint and receive return
- fix(order, core-flows): Tax inclusive order line item adjustments
- fix(orchestration): Handle expected lifecycle errors
- fix(dashboard): show TIP flag only for fixed promotions
๐ View Raw Release Notes (Original Developer Log)
<!--

# v2.8.7: Improved `create-medusa-app` and corrected tax calculations
This release improves the `create-medusa-app` command and corrects tax calculations on orders
CMS_BREAK -->
## Highlights
## New `--version` flag for `create-medusa-app`
This release introduces a new flag, `--version` to the `create-medusa-app` command, allowing you to create Medusa projects with a specific version installed.
```
npx create-medusa-app ---version 2.8.5
```
## Correct tax calculations for order item adjustments
This release introduces the `is_tax_inclusive` flag on order line item adjustments to ensure tax calculations are correct for tax-inclusive promotions.
## Features
* feat(create-medusa-app): Allow to create project with specific medusa version by @adrien2p in https://github.com/medusajs/medusa/pull/12882
## Bugs
* fix(core-flows): Locations levels check in draft order and order edit flows by @olivermrbl in https://github.com/medusajs/medusa/pull/12881
* fix(index): merge filterable fields schema by @carlos-r-l-rodrigues in https://github.com/medusajs/medusa/pull/12888
* fix(): Order constraint and receive return by @adrien2p in https://github.com/medusajs/medusa/pull/12889
* fix(order, core-flows): Tax inclusive order line item adjustments by @olivermrbl in https://github.com/medusajs/medusa/pull/12875
* fix(orchestration): Handle expected lifecycle errors by @adrien2p in https://github.com/medusajs/medusa/pull/12886
* fix(dashboard): show TIP flag only for fixed promotions by @fPolic in https://github.com/medusajs/medusa/pull/12897
* fix(medusa, core-flows): Update TIP on promotions by @olivermrbl in https://github.com/medusajs/medusa/pull/12885
## Documentation
* chore: Bump Kapa SDK by @olivermrbl in https://github.com/medusajs/medusa/pull/12870
## Other Changes
* fix(admin): prevent excessive polling in notifications by @jessy2027 in https://github.com/medusajs/medusa/pull/12868
## New Contributors
* @jessy2027 made their first contribution in https://github.com/medusajs/medusa/pull/12868
**Full Changelog**: https://github.com/medusajs/medusa/compare/v2.8.6...v2.8.7