Link & Append¶
These functions help you reuse objects, materials and other data-blocks from another blend-file. You can build libraries of common content and share them across multiple referencing files.
Tip
Instead of using the menu, you can also Link/Append blend-files by dragging and dropping them into the Blender window.
Note
It’s not possible to Link or Append data from much newer blend-files.
Link¶
Reference
- Editor:
Topbar
- Mode:
All modes except Edit Mode
- Menu:
Link creates a reference to data in a source file such that changes made there will be reflected in the current file the next time it is reloaded. In the File Browser, navigate to the external source blend-file and select the data-blocks you want to reuse.
Linked data-blocks are indicated with a chain icon in the Outliner. They’re also listed in the Outliner’s Blender File Display Mode, along with the path of the blend-file they originate from.
Linked data-blocks are initially not editable. This even includes the location/rotation/scale of linked objects, which are locked to the transformation they have in the source file. There are ways around this, however:
If you link a collection with Instance Collections enabled or some object data with Instance Object Data enabled, the collection/object data will be referenced through an object created inside the current blend-file, which can be transformed. (This new object will be created at the 3D Cursor.)
You can also do some level of editing/animating on linked (and thus normally locked) data-blocks using Library Overrides.
Warning
Since it is not editable, linked data cannot be protected with the Fake User option. Adding a custom property pointing to an otherwise unused linked data-block (e.g. a Text block) is a good way to keep it referenced accross saves and reloads.
Options¶
These options are available in the right-hand panel of the File Browser.
- Relative Path
Reference the external blend-file using a relative path rather than an absolute one.
- Select
Select the newly added objects.
- Active Collection
When enabled, objects and collections will be added to the active collection of the active view layer. Otherwise, they will be added to a new “Linked Data” collection in the active view layer.
- Instance Collections
When enabled, each linked collection will be added to the scene as an instance collection (that is, a single object that represents the entire collection). You can add more such instances using , or replace an instance by the collection contents using Make Instances Real.
When disabled, the collections will be added as-is so you can see their content in the Outliner and create Library Overrides.
- Instance Object Data
When enabled, an object will be created for each directly linked object data. Otherwise, no object will be created and the object data will not be visible in the scene until you create one yourself (e.g. by dragging the object data from the Outliner into the 3D Viewport).
Append¶
Reference
- Editor:
Topbar
- Mode:
All modes except Edit Mode
- Menu:
Append copies data-blocks into your blend-file without keeping any reference to the original ones. You can make further edits to your local copy of the data, but changes in the external source file will not be reflected in the current one.
In the File Browser, navigate to the external source blend-file and select the data-blocks you want to reuse.
Note
Appending data you already have linked will add objects/collections to the scene, but will keep them linked (and uneditable).
This is done so existing relationships with linked data remain intact.
Options¶
These options are available in the right-hand panel of the File Browser.
- Select
Select the newly added objects.
- Active Collection
When enabled, objects and collections will be added to the active collection of the active view layer. Otherwise, they will be added to a new “Appended Data” collection in the active view layer.
- Instance Collections
When enabled, each appended collection will be added to the scene as an instance collection (that is, a single object that represents the entire collection). You can add more such instances using , or replace an instance by the collection contents using Make Instances Real.
When disabled, the collections will be added as-is so you can see their content in the Outliner.
- Instance Object Data
When enabled, an object will be created for each directly appended object data. Otherwise, no object will be created and the object data will not be visible in the scene until you create one yourself (e.g. by dragging the object data from the Outliner into the 3D Viewport).
- Fake User
Marks the appended data-blocks as Protected.
- Localize All
Also copy all indirectly linked data, instead of maintaining the links.
Reload¶
Reference
- Editor:
Outliner
- Menu:
When the Outliner is in the Blender File Display Mode, you can right-click a linked blend-file and choose Reload to immediately update the current blend-file with the latest version of the linked data-blocks, without having to reopen the file.
Relocate¶
Reference
- Editor:
Outliner
- Menu:
When the Outliner is in the Blender File Display Mode, you can right-click a linked blend-file and choose Relocate to replace it by a different file. This can be used to either fix a broken linked library (e.g. because the file was moved or renamed), or to switch to a variation of the same data in a different file.
Broken Libraries¶
If Blender cannot find a library while loading a blend-file, it will create placeholder data-blocks to replace missing linked ones. That way, references to the missing data are not lost, and by relocating the missing library, the lost data can be automatically restored.
Make Local¶
Reference
- Editor:
3D Viewport
- Mode:
Object Mode
- Menu:
Reference
- Editor:
Outliner
- Menu:
Makes the selected or all external objects local to the current blend-file. Links to the original library file will be lost, but the data-blocks will become fully editable, just like the ones directly created in the current blend-file.
Options¶
The operation available from the Outliner’s context menu has no options and only affects the selected data-blocks.
The operation available from the 3D Viewport only affects the selected objects, but it can also make local the objects’ dependencies:
- Type
Whether to localize only the objects themselves, or also their data and materials.
Known Limitations¶
For the most part, linking data will work as expected. However, there are some limitations to be aware of.
Circular Dependencies¶
In general, dependencies should not go in both directions. Attempting to link or append data which links back to the current file will likely result in missing links.
Scene-Level Settings¶
Scene-level settings such as the Rigid Body World will not be copied when linking objects. As an alternative, you can link the entire scene and use it as a Background Scene.
Compression & Memory Use¶
Referencing compressed blend-files may need a lot of memory because they have to be loaded in their entirety, even if you only link/append a small part of them. Once the data-blocks are loaded, however, memory usage is the same.