Impact Score: 5/10
Medusa: v2.8.6: Strengthened workflow engine and improved account holder management
Source available โ automated, not human-reviewed
Component: medusajs ยท Channel: stable. Automated analysis, not a compatibility certification. How this works.
Analysis updated: 2026-11-01.
โก Executive Summary (TL;DR)
Medusa v2.8.6. Source highlight: Strengthen the workflow engine
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 (6)
- docs: added first-purchase promotion guide
- docs: added gift message guide
- docs: add build with AI & LLMs doc
- chore: add version and deprecated tags to import routes and methods
- chore: add missing types in TSDocs example
- feat: Admin translation update for czech language
โก Performance & Enhancements (1)
- chore: improve description of findOrCreateCustomerStep
๐ง Bug Fixes & Patches (6)
- fix: do not apply prefix when getting file contents as buffer or stream
- fix(core-flows,workflows-sdk): compensate account holders only when its created
- fix(): test utils events + workflow storage
- fix: fix onScroll in Select.Content by @peterlgh7 in #12855
- docs: fix step detection of useQueryGraphStep
- docs: small typo fix
๐ View Raw Release Notes (Original Developer Log)
<!--

# v2.8.6: Strengthened workflow engine and improved account holder management
This release improves the workflow engine's data management and payment account holder flows.
CMS_BREAK -->
## Highlights
### Strengthen the workflow engine
This release improves the workflow engine's data flow. When resuming workflows, we now compile workflow data (i.e. input and outputs of previous steps) from Redis and Postgres to ensure the most recent workflow execution and associated data are used.
### Improve payment account holder flows
This release improves how payment account holders are managed when creating payment sessions in the `createPaymentSessionWorkflow`. In this workflow, we create a new payment account holder for the customer on the cart if it doesn't already exist. When the workflow fails in a later step, the compensation flow is triggered, and we now ensure we are only deleting the account holder if it was created as part of the invoke, i.e. it didn't exist before running the workflow.
## Bugs
* fix: do not apply prefix when getting file contents as buffer or stream by @thetutlage in https://github.com/medusajs/medusa/pull/12831
* fix(core-flows,workflows-sdk): compensate account holders only when its created by @riqwan in https://github.com/medusajs/medusa/pull/12825
* fix(): test utils events + workflow storage by @adrien2p in https://github.com/medusajs/medusa/pull/12834
* fix: fix onScroll in Select.Content by @peterlgh7 in #12855
## Documentation
* docs: documentation changes for next release by @shahednasser in https://github.com/medusajs/medusa/pull/12773
* doc: Updated cloudflare R2 description by @scherddel in https://github.com/medusajs/medusa/pull/12598
* docs: added first-purchase promotion guide by @shahednasser in https://github.com/medusajs/medusa/pull/12828
* docs: update OAS for loyalty plugin by @shahednasser in https://github.com/medusajs/medusa/pull/12836
* docs: remove usages of ts-ignore in examples by @shahednasser in https://github.com/medusajs/medusa/pull/12839
* docs: fix step detection of useQueryGraphStep by @shahednasser in https://github.com/medusajs/medusa/pull/12842
* docs: small typo fix by @shahednasser in https://github.com/medusajs/medusa/pull/12843
* docs: documet withDeleted by @shahednasser in https://github.com/medusajs/medusa/pull/12841
* docs: design fixes to toc and related elements by @shahednasser in https://github.com/medusajs/medusa/pull/12747
* docs: added gift message guide by @shahednasser in https://github.com/medusajs/medusa/pull/12833
* docs: sort events in reference alphabetically by @shahednasser in https://github.com/medusajs/medusa/pull/12845
* docs-util: throw when schema parsing fails by @shahednasser in https://github.com/medusajs/medusa/pull/12846
* docs: remove empty storefront guides by @shahednasser in https://github.com/medusajs/medusa/pull/12844
* docs: add build with AI & LLMs doc by @shahednasser in https://github.com/medusajs/medusa/pull/12848
* docs: document tax-inclusive promotions concept by @shahednasser in https://github.com/medusajs/medusa/pull/12849
## Chores
* chore: add version and deprecated tags to import routes and methods by @shahednasser in https://github.com/medusajs/medusa/pull/12829
* chore: add missing types in TSDocs example by @shahednasser in https://github.com/medusajs/medusa/pull/12835
* chore: improve description of findOrCreateCustomerStep by @shahednasser in https://github.com/medusajs/medusa/pull/12840
## Other Changes
* feat: Admin translation update for czech language by @redeyecz in https://github.com/medusajs/medusa/pull/12837
## New Contributors
* @scherddel made their first contribution in https://github.com/medusajs/medusa/pull/12598
* @redeyecz made their first contribution in https://github.com/medusajs/medusa/pull/12837
**Full Changelog**: https://github.com/medusajs/medusa/compare/v2.8.5...v2.8.6