v1.18

Version 1.18 of Medusa ships improved Subscriber and Scheduled Job APIs, renamed feature flags, and general big fixes.

Breaking Changes

Changed Feature Flags

This version replaced the module-specific feature flags used in the core @medusajs/medusa with a feature flag that encapsulates all the work around modularizing Medusa further.

The following feature flags no longer exist:

• isolate_product_domain or MEDUSA_FF_ISOLATE_PRODUCT_DOMAIN: Previously used as the feature flag for the Product Module in the core.
• isolate_pricing_domain or MEDUSA_FF_ISOLATE_PRICING_DOMAIN: Previously used as the feature flag for the Pricing Module in the core.

These feature flags are replaced by the medusa_v2 feature flag name, or the MEDUSA_FF_MEDUSA_V2 environment variable. All modularization work moving forward will be guarded by this feature flag.

Subscribing Notification Providers

In previous versions, Notification Provider Services subscribed to events in a Subscriber. Following the improvement in the Subscriber API, you have to use a Loader to subscribe Notification Providers to events as explained here.

---

How to Update

Run the following command in your project:

• npm
• Yarn
• pnpm

npm install @medusajs/medusa@1.18

yarn add @medusajs/medusa@1.18

pnpm add @medusajs/medusa@1.18

To avoid unexpected issues with dependencies, it's also recommended to update all other Medusa plugins or packages you have installed.

---

Actions Required

Run Migrations

After updating your Medusa server and before running it, run the following command to run the latest migrations:

npx medusa migrations run