subscriber-default-export-must-be-async - ESLint plugin rules

This rule requires the default-exported subscriber handler function to be async.

Severity#

error. This rule is enabled in the recommended preset.

What it Targets#

This rule targets files in your project's src/subscribers directory. It reports a default-exported subscriber handler that isn't an async function.

The following code is reported by the rule:

src/subscribers/order-placed.ts
export default function orderPlacedHandler() {}

Instead, make the handler async:

src/subscribers/order-placed.ts
export default async function orderPlacedHandler() {}

Why it's Important#

Subscribers receive an event and are always awaited by Medusa. Making the handler async ensures Medusa can wait for its work to finish before continuing.

Learn more in the Subscribers documentation.

Fixable#

This rule is auto-fixable. Run the linter with the --fix option to apply the fix automatically.

Was this page helpful?
Ask Bloom
For assistance in your development, use Claude Code Plugins or Docs MCP server in Cursor, VSCode, etc...FAQ
What is Medusa?
How can I create a module?
How can I create a data model?
How do I create a workflow?
How can I extend a data model in the Product Module?
Recipes
How do I build a marketplace with Medusa?
How do I build digital products with Medusa?
How do I build subscription-based purchases with Medusa?
What other recipes are available in the Medusa documentation?
Chat is cleared on refresh
Line break
⇧↵