diff --git a/README.md b/README.md
index 1e2ade6d..26e85e65 100644
--- a/README.md
+++ b/README.md
@@ -168,6 +168,22 @@ class MyCustomLink extends Link
 
 Custom links can have validation set using standard [model validation](https://docs.silverstripe.org/en/5/developer_guides/forms/validation/#model-validation).
 
+## Migration form LinkField v3 to v4
+
+The `Title` DB field has been renamed to `LinkText`
+
+You can manually rename this column in your database with the following:
+
+```php
+// app/_config.php
+
+use SilverStripe\ORM\DB;
+
+// Only run this once
+// This will rename the `Title` field to `LinkText` in all relevant tables
+DB::get_conn()->getSchemaManager()->renameField('LinkField_Link', 'Title', 'LinkText');
+```
+
 ## Migrating from Shae Dawson's Linkable module
 
 https://github.com/sheadawson/silverstripe-linkable