# Medusa v2.10.0 — Release & Upgrade Intelligence
- **Product:** Medusa (https://medusajs.com)
- **Version:** v2.10.0
- **Released:** Aug 28, 2025
- **Impact Score:** 7/10
- **Breaking Changes:** Source flagged
- **Canonical Analysis:** https://changelogs.us/medusajs/updates/v2.10.0/

## Executive Summary (TL;DR)
Medusa v2.10.0. Source highlight: This release contains breaking changes, so please read the release notes carefully. The breaking changes are all the result of fixing behavior that has not worked as intended until now.

## Breaking Changes & Deprecations
- This release contains breaking changes, so please read the release notes carefully. The breaking changes are all the result of fixing behavior that has not worked as intended until now.
- Breaking change The `idempotent` configuration on workflows no longer retains executions in the database after completion, unless a retention time is specified. Up until now, if the `idempotent` flag was set, workflow executions were retained indefinitely, which was never the intention. The intention was to make a workflow idempotent for the duration of its execution, and only longer if the retention time was explicitly configured.
- Breaking change The return types of `update` and `create` in `MedusaService` have been corrected to properly handle the different shapes of inputs.
- Breaking change Previously, if the `emitEventStep` queued an event and the workflow later failed, the compensating flow would emit that queued event instead of removing it. This caused unexpected behavior during rollback.
- Breaking change The admin dashboard now supports managing shipping option types, making it easier to categorize options such as Standard and Express.
- This migration will only affect Shipping Options that reference the `type-code` type. If you have been using your own types, they will remain as is. On the contrary, if you have been relying on `type-code`, this is a breaking change.

## New Features
- feat(dashboard, js-sdk): shipping option type mngmt dashboard
- feat: view config feature flag
- feat: add settings module
- feat(api): add view configuration API routes
- feat: add column introspection api
- feat(dashboard, core-flows): associate shipping option to type

## Improvements
- docs: improve examples of selecting fields and relations in the API reference
- chore: improve ignore build script to ignore branches not starting with docs/
- Improve German Admin Translations (de.json)

## Bug Fixes
- fix(orchestration): Use the step definition max retries on set step failure
- fix(utils): fix promotion case of each allocation not applying its total amount
- fix(utils): auto generated update method return
- fix(dashboard): table inclusive date filter
- fix(dashboard): create product selected inventory item display
- fix(core-flows, dashboard, types): improve allocation flows on Admin