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

## Executive Summary (TL;DR)
Medusa v2.8.6. Source highlight: Strengthen the workflow engine

## New Features
- 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

## Improvements
- chore: improve description of findOrCreateCustomerStep

## Bug Fixes
- 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