missing docs on how to create data migration scripts

[SteelRazor47]

What Medusa version and documentation are you using?

v2

Preliminary Checks

• This issue is not a duplicate. Before opening a new issue, please search existing issues: https://github.com/medusajs/medusa/issues

Issue Summary

I have a use case for data migration scripts, and I found out that they aren't documented at all really.
I knew they existed, as I had seen them running during migrations, but I had to Ctrl+F the release notes(https://github.com/medusajs/medusa/releases/tag/v2.3.0) to find out how and where to create them and had to look at the source code for an actual example of the function signature.

I'd be nice to have a small section about them. Even a copy-paste of the relevant 2.3.0 release notes section and a stripped down version of this script would suffice.

How can this issue be resolved?

Are you interested in working on this issue?

• I would like to fix this issue

[SumitGarg11]

Hi 👋,

Thank you for raising this — you’re absolutely right, there isn’t a dedicated section that explains how to create and use data migration scripts properly.

I see it’s briefly mentioned in the Deployment > General page (screenshot attached below), but there’s no detailed example or step-by-step guide.

I’ll work on adding a clear section based on the v2.3.0 release notes, with a simple example and instructions, so it’s easier for everyone to find and use.

Thanks again for pointing this out! 🚀

[github-actions]

This issue is stale because it has been open 30 days with no activity. Remove stale label or comment or this will be closed in 3 days.