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

## Executive Summary (TL;DR)
Medusa v2.22.0. Source highlight: Node.js v22.22.0 or Later Required

## Breaking Changes & Deprecations
- 🚧 Breaking change > This change only affects projects running Node.js 20. Projects already on Node.js 22 are unaffected.

## New Features
- feat(dashboard, core-flows, js-sdk, types, medusa): add export customers feature by @shahednasser in #16142
- feat: Support multiple payment accounts for medusa payments by @sradevski in #17099
- feat: Add missing events for price lists and few others needed to keep a product index up to date by @sradevski in #17067
- feat(dashboard): add refund reason selector to balance settlement form by @vansh17June in #16669
- feat(dashboard): allow removing tracking rows in the create shipment form by @AndyMik90 in #17154
- feat(dashboard): add Iran provinces to country-states by @soroush2025 in #17199

## Improvements
- chore: improve the tsdocs related to currency lower case by @shahednasser in #17071

## Bug Fixes
- fix(medusa): stop exporting sensitive HTTP headers and redact URL query params in spans by @medusa-agents in #17361
- fix(auth-emailpass,types): add `requireActorAssociation` option to refuse logins on unassociated actor types by @medusa-agents in #17347
- fix: Correctly reindex id-based filters by @sradevski in #17354
- fix(auth): update the provider identity matching the entity_id from auth providers by @medusa-agents in #17337
- fix(docs): include imported MDX partials in agent markdown and mark override pages as human-only by @medusa-agents in #17335
- fix(@medusajs/medusa): accept case-insensitive order directions and report single-query errors on POST /store/search by @medusa-agents in #17313