Asset Browser¶

The Asset Browser is the main interface for organizing and using assets.

Interface¶

../_images/asset_browser-gold-material.png — Asset Browser, showing materials in an asset library.¶

Main Region¶

The center region of the Asset Browser lists the assets contained in the selected catalog.

Click LMB to select a single asset. Additionally hold Ctrl to add/remove that asset to/from the selection, or Shift to select a range of assets. You can also drag LMB to perform a box select.

The region has a context menu with the following operations:

Refresh Asset Library R: Refreshes the list.
Clear Asset: See Removing Assets.
Clear Asset (Set Fake User): See Removing Assets.
Open Blend File: Opens the blend-file containing the asset.
Display Size: Changes the size of the preview thumbnails.

Asset Library Region¶

The region on the left lets you select an asset library and shows its catalogs. You can show/hide this region by pressing T.

Asset Library

The asset library whose catalogs to show.

All Libraries:: Show catalogs from all available libraries.
Current File:: Show the catalogs in the current blend-file (even if that file is not yet part of an asset library). See The Current File Asset Library for more information.
Essentials:: Show the catalogs that come bundled with Blender.

Any libraries that you added in the File Path Preferences are listed here too.

Copy Bundle to Asset Library

Shown when Asset Library is set to Current File and the current blend-file is an asset bundle that’s not yet part of an asset library.

Lets you select a target asset library, then opens a File Browser in that library’s root folder so you can save the current blend-file there. Once saved, the assets in the blend-file become available as part of the library.

Catalogs

Tree view that shows the catalogs of the selected asset library. A catalog is a group of assets; when you select one, only the assets in that catalog and its child catalogs will be listed.

You can rename a catalog by double-clicking it, or assign it to a different parent catalog by dragging and dropping.

Add-ons and features like the Pose Library can show custom panels here.

Asset Details Region¶

The region on the right shows the metadata of the active asset. You can show/hide this region by pressing N or clicking the gear icon in the header.

Only metadata of assets contained in the current blend-file can be edited.

Name: The asset’s name. Unique for the asset data type within the same blend-file.

Source

The full path of the blend-file that contains the asset.

Open Blend File: Opens the blend-file that contains the asset in a new Blender instance. When this instance is closed, the Asset Browser will be automatically refreshed.

License: Optional name of the license under which this asset is distributed. Not used by Blender itself.

Copyright: Optional copyright notice. Not used by Blender itself.

Description: Optional asset description. Not used by Blender itself.

Author: Optional field for the asset author. Not used by Blender itself.

Preview¶

Shows the preview image of the asset. See Asset Previews.

Load Custom Preview: Opens a File Browser where you can select a new image for the asset preview.

Generate Preview

Autogenerate a new preview for the asset.

Preview

Menu of additional preview operators.

Render Active Object: Generates a preview based on the 3D Viewport’s Active object. This is useful for node groups, which cannot automatically generate their own preview.

Tags¶

Panel for viewing and editing asset tags. These do not have any meaning to Blender and can be chosen freely. When using the search field to filter the assets, the assets whose tags (partially) match the search term will also be shown.

Note

Depending on the current mode of the object and the selected asset types, more panels may be shown. For example, see Pose Library.

Using Assets¶

As a general rule, an asset can be used by dragging it from the Asset Browser to the desired location. Objects and worlds can be dragged from the Asset Browser into the scene. Materials can be dragged onto the object that should use them. Geometry nodes can also be dragged onto objects to add a Geometry Nodes Modifier. The use of pose assets is different, and is described in Pose Library.

There are several things that can happen when an asset is used, depending on the following configuration of the Asset Browser:

Import Method

Determines how data is managed when an asset is imported. This option can be found in the center of the Asset Browser header (when an asset library other than Current File or Essentials is selected):

Follow Preferences

Use the import method set in the File Path Preferences.

Link

Same as File ‣ Link…

The asset will be linked to the current blend-file, and thus be read-only. Later changes to the asset file will be reflected in all files that link it.

Append

Same as File ‣ Append…

The asset and all its dependencies will be copied into the current file. Dragging a material into the scene three times will result in three independent copies. Dragging an object into the scene three times will also result in three independent copies.

“Dependencies” in this case means everything the asset refers to. For an object, this can be its mesh and materials, but also other objects used by modifiers, constraints, or drivers.

Since the file now has its own copy of the asset, later changes to the asset file will not be reflected in the file it’s appended to.

Append (Reuse Data)

Specific to the Asset Browser.

The first time an asset is used, it will be appended, including its dependencies, just as described previously. However, Blender will keep track of where it originated, and the next time the asset is used, as much data as possible will be reused. Dragging a material into the scene three times will only load it once, and just assign the same material three times. Dragging an object into the scene three times will create three copies of the object, but all copies will share their mesh data, materials, etc.

Since the file now has its own copy of the asset, later changes to the asset file will not be reflected in the file it’s appended to.

Tip

Instancing Collections

Mimics the Instance Collections option when appending from the file browser

Some asset types such as collections can be created as an instanced collection. This is done by enabling the Instance option after dragging collection assets into the 3D Viewport. By enabling this option, an empty object is added that uses an instance of the collection. If this option is disabled, the full collection hierarchy will be added to the scene.

Collection Assets from the current file will always be instanced.

Note that all regular Blender operations are available after the asset has been added to the current file. For example, you could choose to link an object to the scene; this will also link its mesh and its materials. Then you can make the object itself local (Object ‣ Relations ‣ Make Local… ‣ Selected Objects), while keeping the mesh and materials linked to the asset files. This will result in a local, and thus editable, object, and keep the mesh and materials automatically up to date with any changes in the asset library.

Asset Previews¶

../_images/asset-browser-preview-panel.png — Preview panel in the Asset Browser.¶

Preview images are typically generated automatically when you mark a data-block as an asset. Objects are captured from their local -Y axis, while collections are captured from the global -Y axis (as these don’t have a local axis).

If the auto-generated preview image isn’t sufficient, you can replace it by a custom one.

For previews of pose assets, see Controlling the Look of Preview Images.

Asset Bundles¶

Asset bundles are blend-files that do not reference any other file, and whose name ends in _bundle.blend. Any textures and other external files need to be packed into the current blend-file.

Asset bundles can be copied to an asset library via the Asset Browser:

Open the asset bundle blend-file.
Switch its Asset Browser to Current File (if it’s not set to that already).
Click on Copy Bundle to Asset Library.
Choose the asset library to copy it to.
A File Browser will open at the root folder of the selected asset library. Choose the desired location of the blend-file, and click the Copy to Asset Library button.
The blend-file will be saved at the chosen location, and any catalogs of the asset bundle will be merged into the target asset library.

Note

Both the word “asset” and the word “bundle” are commonly used, and not necessarily with the same meaning as described here. Not everything that’s presented as an “asset bundle” will have the Copy to Asset Library functionality available; for that, the bundle file needs to adhere to the definition above.