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

## Executive Summary (TL;DR)
Medusa v2.11.0. Source highlight: This release adds new caching primitives to Medusa's toolbox.

## Breaking Changes & Deprecations
- This is a breaking change, and the following steps are required to use versions 2.11.0 and over:

## New Features
- New Campaign Budget Type added `USE_BY_ATTRIBUTE` to support per-attribute usage tracking.
- New entity `CampaignBudgetUsage` added: tracks usage counts per attribute.
- Added attribute field (e.g. `customer_id`) to define the usage key
- Added `usages` relation expanding `CampaignBudgetUsage`
- Feat(): faster entity serializer
- feat(js-sdk): allow passing a query parameter to deleteLineItem

## Improvements
- docs: improve docs contribution guidelines
- docs: improve troubleshooting guide for pnpm
- docs: improved analytics and tracking
- docs: improve headings and context in Cloud docs
- docs: improve references loading
- Chore/promo improve further

## Bug Fixes
- fix(dashboard): improve inventory level location management
- fix(auth-emailpass): better handle identity with same email error
- fix(medusa-test-utils): add health endpoint in test server
- fix(types): pluralize settings
- fix(engine): Always create cleaner job
- fix(types): missing service zone in shipping option