# Medusa v2.8.8 — Release & Upgrade Intelligence
- **Product:** Medusa (https://medusajs.com)
- **Version:** v2.8.8
- **Released:** Jul 24, 2025
- **Impact Score:** 5/10
- **Breaking Changes:** Not verified
- **Canonical Analysis:** https://changelogs.us/medusajs/updates/v2.8.8/

## Executive Summary (TL;DR)
Medusa v2.8.8. Source highlight: Carry over cart promotions to order

## New Features
- docs: add missing prop to kapa
- docs: added a note linking to create-medusa-app reference
- docs: add a troubleshooting section on creating a payment session with zero total
- docs: add examples to price rules and tiers
- docs: add a section on shipping options and requirement + improvements
- docs: add inject dependencies section in module tests + improvements

## Improvements
- docs: improvements to the "Expose a Workflow Hook" documentation
- docs: improve alt of images
- chore(orchestration): improve transaction errors

## Bug Fixes
- fix(link-modules,core-flows): Carry over cart promotions to order promotions
- fix(core-flows): updating tax lines when draft order shipping is removed
- fix(types): add attachments to CreateNotificationDTO type
- fix(dashboard): combobox multiitem clear
- fix(core-flows): useQueryGraph util return type
- chore(workflow-engine-*): Align event subscribers management