Docs

Integration Module for Medusa

Integration Module

No-code UI for Medusa plugin settings

A plugin describes its options as a schema, and store admins manage them in the Medusa Admin, with no medusa-config edits and no redeploys. The module takes care of the UI, storage, encryption, and validation.

Read docs
Integration Module

Overview

Built for the people who run the store

The module generates a settings UI for every plugin from its declarative description. There are no admin pages to build and no redeploys to schedule.

No-code settings UI

No-code settings UI

Credentials, modes, and webhooks live under Settings → Integrations. Change a value and it takes effect right away.

Encrypted by default

Encrypted by default

The module encrypts options marked secret at rest with AES-256-GCM, and they never reach the browser.

Connection test

Connection test

Test the connection to the third-party service straight from the Admin, then the module keeps checking it every day. A dead key shows up in Settings, not at checkout.

Any plugin, provider, or module

Any plugin, provider, or module

Payment, fulfillment, notification, ERP, content, or a module of your own. If a store admin should be able to manage a setting, the Integration Module can handle it.

Multiple instances

Multiple instances

Connect the same provider several times, for example a primary and a backup gateway, or a separate account per region. Each instance keeps its own settings.

Live now

Running on the Integration Module

The catalog keeps growing, from payments and fulfillment to ERP. Find the integration you need and configure it right in the Medusa Admin.

Your plugin in every Medusa Admin

Add your integration to the catalog available from any Medusa Admin. Developers and store owners looking for ready-made solutions will find you there.

Read docs
Your plugin in every Medusa Admin

Features

A first-class settings UI for every plugin, without code

Simple for integration developers, convenient for store admins.

For developers

  • One declarative descriptor for all plugin settings

  • Options, sections, validation, and a connection test in one file

  • The module generates the UI and API, so you write none of it yourself

  • Typed options: string, url, email, uuid, number, boolean, enum, json

  • Validation rules per option and across sections

  • Conditional visibility and read-only fields

  • Read typed, decrypted option values anywhere in your code

  • Ship your own widget when the generated sections aren't enough

  • Localize your settings with Medusa's own admin i18n

For store admins

  • Every plugin and provider setting in one place

  • Changing a value takes no medusa-config edit and no redeploy

  • Clear status: not configured, incomplete, enabled, disabled

  • Several instances of one provider for different accounts, regions, or purposes

  • Secrets encrypted at rest with AES-256-GCM

  • Connection test on demand, plus an automatic daily re-check

  • Disable an integration without losing the values you entered

  • Find ready-made integrations in the catalog inside the Admin