Medusa v2.8.7stable Released Jul 08, 2025
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.

Compatibility not verified โ€” check source notes
๐Ÿ“„ .MD
โšก 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)
<!-- ![2-8-7](https://gh-release-images.s3.eu-north-1.amazonaws.com/v-2-8-7.png) # 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