diff --git a/app/assets/javascripts/discourse/app/lib/plugin-api.js b/app/assets/javascripts/discourse/app/lib/plugin-api.js
index 9457a17b193..71e4bccb8fd 100644
--- a/app/assets/javascripts/discourse/app/lib/plugin-api.js
+++ b/app/assets/javascripts/discourse/app/lib/plugin-api.js
@@ -985,6 +985,10 @@ class PluginApi {
    * api.renderInOutlet('user-profile-primary', <template>Hello world</template>);
    * ```
    *
+   * Note that when passing a component definition to an outlet like this, the default
+   * `@connectorTagName` of the outlet is not used. If you need a wrapper element, you'll
+   * need to add it to your component's template.
+   *
    * @param {string} outletName - Name of plugin outlet to render into
    * @param {Component} klass - Component class definition to be rendered
    *