diff --git a/wiki/BIM_Link.wikitext b/wiki/BIM_Link.wikitext
index ee14fbb3f0..b1b0f81ef5 100644
--- a/wiki/BIM_Link.wikitext
+++ b/wiki/BIM_Link.wikitext
@@ -26,6 +26,8 @@
 <!--T:4-->
 The [[File:BIM_Link.svg|24px]] [[BIM_Link|BIM Link]] command is a shortcut to [[Std_LinkMake|Std LinkMake]], but starts a [[Draft_Move|Draft Move]] operation immediately after, allowing a link to be created and placed in one go.
 
+It creates an {{incode|App::Link}} object that references the selected source object. This is useful when the same BIM object has to appear several times in a model, for example repeated windows, equipment, rebars or curtain-wall elements, while keeping the repeated objects lightweight.
+
 ==Usage== <!--T:5-->
 
 <!--T:6-->
@@ -38,6 +40,17 @@ The [[File:BIM_Link.svg|24px]] [[BIM_Link|BIM Link]] command is a shortcut to [[
 # The [[Draft_Move|Draft Move]] command starts automatically.
 # Click in the [[3D_View|3D View]] to place the new link.
 
+==Notes==
+
+* The command requires at least one selected object.
+* The created object is a standard FreeCAD {{incode|App::Link}}, so changes to the linked source object are reflected by its links.
+* Compared with [[BIM_Clone|BIM Clone]], links are intended for lightweight repeated references to the same geometry. Clones remain available and may still be better supported in older BIM workflows.
+* For BIM objects that need object-specific host information, such as windows, rebars, curtain walls and equipment, the workbench can keep selected link properties independent from the source object. This allows a linked window, for example, to be hosted by a different wall without changing the original window.
+
+==Scripting==
+
+The command creates an {{incode|App::Link}} and assigns its {{incode|LinkedObject}} to the selected source object. It then starts the [[Draft_Move|Draft Move]] command for the newly created link.
+
 
 <!--T:7-->
 {{Docnav
@@ -51,4 +64,4 @@ The [[File:BIM_Link.svg|24px]] [[BIM_Link|BIM Link]] command is a shortcut to [[
 
 </translate>
 {{BIM_Tools_navi{{#translation:}}}}
-{{Userdocnavi{{#translation:}}}}
\ No newline at end of file
+{{Userdocnavi{{#translation:}}}}