Skip to content

Document BIM Link behavior #281

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
genson1808 wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Document BIM Link behavior #281

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
65bca59
Document BIM Link behavior
genson1808 May 22, 2026
95e05e0
Remove manual translation markers from BIM Link docs
genson1808 May 23, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 14 additions & 1 deletion wiki/BIM_Link.wikitext
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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-->
Expand All @@ -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
Expand All @@ -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:}}}}
{{Userdocnavi{{#translation:}}}}