diff --git a/www/docs/en/12.x-2025.01/guide/hybrid/plugins/index.md b/www/docs/en/12.x-2025.01/guide/hybrid/plugins/index.md
index f748773b5f..ab8c58f735 100644
--- a/www/docs/en/12.x-2025.01/guide/hybrid/plugins/index.md
+++ b/www/docs/en/12.x-2025.01/guide/hybrid/plugins/index.md
@@ -193,8 +193,7 @@ Cordova app as usual and add the plugin with the `--link` option:
 cordova plugin add ../path/to/my/plugin/relative/to/project --link
 ```
 
-This creates a symbolic link instead of copying the plugin files, which enables you
-to work on your plugin and then simply rebuild the app to use your changes.
+This creates a symbolic link instead of copying the plugin files, which enables you to work on your plugin and then simply rebuild the app to use your changes. The plugin should be added after the platform, or the link will not work. The link will also be lost if you re-add the platform or [restore the project](../../../platform_plugin_versioning_ref/index.md) with `cordova prepare`. In that case, you'll need to re-add the plugin to restore the link.
 
 ## Validating a Plugin using Plugman
 
diff --git a/www/docs/en/dev/guide/hybrid/plugins/index.md b/www/docs/en/dev/guide/hybrid/plugins/index.md
index f748773b5f..ab8c58f735 100644
--- a/www/docs/en/dev/guide/hybrid/plugins/index.md
+++ b/www/docs/en/dev/guide/hybrid/plugins/index.md
@@ -193,8 +193,7 @@ Cordova app as usual and add the plugin with the `--link` option:
 cordova plugin add ../path/to/my/plugin/relative/to/project --link
 ```
 
-This creates a symbolic link instead of copying the plugin files, which enables you
-to work on your plugin and then simply rebuild the app to use your changes.
+This creates a symbolic link instead of copying the plugin files, which enables you to work on your plugin and then simply rebuild the app to use your changes. The plugin should be added after the platform, or the link will not work. The link will also be lost if you re-add the platform or [restore the project](../../../platform_plugin_versioning_ref/index.md) with `cordova prepare`. In that case, you'll need to re-add the plugin to restore the link.
 
 ## Validating a Plugin using Plugman