diff --git a/topics/appendix/tools/gradle_intellij_plugin/tools_gradle_intellij_plugin.md b/topics/appendix/tools/gradle_intellij_plugin/tools_gradle_intellij_plugin.md
index 6d337bf7b..d7ea3ee93 100644
--- a/topics/appendix/tools/gradle_intellij_plugin/tools_gradle_intellij_plugin.md
+++ b/topics/appendix/tools/gradle_intellij_plugin/tools_gradle_intellij_plugin.md
@@ -599,6 +599,10 @@ Assembles a plugin and prepares ZIP archive for [deployment](publishing_plugin.m
 
 `buildPlugin` task extends the [`Zip`](https://docs.gradle.org/current/dsl/org.gradle.api.tasks.bundling.Zip.html) Gradle task.
 
+> Do not repackage libraries into the main plugin archive, see [](plugin_content.md#plugin-with-dependencies).
+>
+{style="warning"}
+
 #### `archiveBaseName`
 {#tasks-buildplugin-archivebasename}
 
diff --git a/topics/appendix/tools/intellij_platform_gradle_plugin/tools_intellij_platform_gradle_plugin_tasks.md b/topics/appendix/tools/intellij_platform_gradle_plugin/tools_intellij_platform_gradle_plugin_tasks.md
index 3bfa67a34..672943969 100644
--- a/topics/appendix/tools/intellij_platform_gradle_plugin/tools_intellij_platform_gradle_plugin_tasks.md
+++ b/topics/appendix/tools/intellij_platform_gradle_plugin/tools_intellij_platform_gradle_plugin_tasks.md
@@ -163,6 +163,9 @@ The produced archive is stored in the <path>[buildDirectory]/distributions/[`arc
 The [`archiveFile`](#buildPlugin-archiveFile) name and location can be controlled with properties provided with the [`Zip`](https://docs.gradle.org/current/dsl/org.gradle.api.tasks.bundling.Zip.html) base task.
 By default, the `archiveBaseName` is set to the plugin name specified in the <path>plugin.xml</path> file, after it gets patched with the [`patchPluginXml`](#patchPluginXml) task.
 
+> Do not repackage libraries into the main plugin archive, see [](plugin_content.md#plugin-with-dependencies).
+>
+{style="warning"}
 
 ### `archiveFile`
 {#buildPlugin-archiveFile}