Skip to main content
Skip to main content


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 install @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
Was this section helpful?