diff --git a/README.md b/README.md
index 41f98395f..13c8bfc1e 100644
--- a/README.md
+++ b/README.md
@@ -163,6 +163,19 @@ TEST=true python -m test.test_api_usage -f
 TEST=true python -m test.test_api_usage -f SuiteName
 ```
 
+
+### Running migrations
+
+```
+# To create a new migration with this description.
+# Note there might be some errors about unique id being to long
+# That's okay as long as the migration file is created
+./data/migrations/migration.sh "Description goes here"
+
+# To test the up and down of the migration
+./data/migrations/migration.sh # without params
+```
+
 ## Documentation
 
 * [Quay Enterprise Documentation](https://tectonic.com/quay-enterprise/docs/latest)