Skip to content

Import Assets

Importing an asset downloads any missing files (first time) then links or creates the corresponding Blender data so you can place, assign, or edit it immediately.

  • Object

    Mesh / multi-object content: imports linked objects into the active collection.
    Steps

  • Texture / Material

    Builds a material, assigns to selected objects, mutes missing maps gracefully.
    Steps

  • Heightmap

    Creates displaced plane with node network ready for sculpting or shading.
    Steps

  • Troubleshoot

    Slow downloads, missing textures, or update conflicts.
    Fixes

At a Glance

Type Trigger Creates / Updates Placement Behavior Notes
Object Import button Links objects / collections Into active collection and places at cursor after click Downloads missing data first
Material Import button New material or updates existing node group Assigns to currently selected objects Missing maps muted
Heightmap Import button Plane + displacement node setup Places plane at origin High-res meshes can be heavy
  • Use Object for geometry you want to place multiple times.
  • Use Material to standardize look across selected objects.
  • Use Heightmap for terrain prototyping or displacement-based workflows.

Caching & re-use

Already downloaded assets are validated via checksum; re-import is near instantly unless you switched version/quality.

Requirements

Asset owned.

Signed in for first download or if not cached.

Internet if asset not installed locally.

Choose Version & Quality (optional)

Asset details: version & quality dialog

  1. Click the gear icon on the owned asset card. Asset card gear icon
  2. The dialog lists available Quality and Version options.
  3. Select the desired version and quality.
  4. (Optional) Click the Check for Updates button to refresh available builds.
  5. Confirm to save the selection.

Import Steps

The common import flows are grouped below — pick the tab for the asset type you're working with (or jump via the cards above).

Object asset import — download and place.

  1. Click Import on the owned asset card.
  2. Sign in if prompted or allow the add-on to fetch identifiers.
  3. If the asset isn't cached it downloads while you choose placement.
  4. The objects link into the active collection.

Material asset import — download and assign.

  1. Select the target objects in Blender.
  2. Click Import on the material asset.
  3. A material is created (or updated) and assigned to the selected objects.
  4. Texture nodes are filled where files exist; missing maps are muted.

Material slot behavior

Materials do not overwrite existing ones. They are inserted into new slots at the bottom of the material stack.

Heightmap asset — imported plane with displacement setup.

  1. Click Import.
  2. After the download completes (if needed) a plane with a displacement setup is created for easy editing.

Progress & Cancellation

Download UI

A compact progress bar appears on the asset card while remote data transfers. If the bar vanishes too quickly it likely hit the local cache.

  • Progress bar shows during download.
  • Cancel button (X icon) or ESC stops download; import ends.
  • On cancellation, partial files are cleaned up; cache remains consistent.

After Import

  • You can re-import with different version/quality by changing settings then repeating.
  • Re-importing an Object duplicates linked object instances; delete unwanted copies manually.
  • Re-importing a Material updates the node tree (if structure unchanged) else creates a new suffixed material.
  • Heightmap re-import spawns a fresh plane; consider using Collections to organize iterations.

Troubleshooting

Slow download
  • Check other network usage; large textures or height maps can be >100MB.
  • Try importing a smaller asset to test baseline speed.
  • See Offline & Caching for cache location.
Missing textures after import
  • Ensure all maps finished downloading (progress reached 100%).
  • Click import again (cached files will validate quickly).
  • Paths still broken? Restart Blender to rebuild search paths.
Version mismatch
  • If objects look wrong after switching version, re-open the Version & Quality dialog and confirm the intended build.
  • Clear local cache for that asset (if feature available) then re-import.
Material node differences

Some older asset versions may use legacy node groups; updating quality can migrate nodes. Always test in a duplicate file when upgrading large scenes.

Next Steps

  • Manage Variants & Updates

    Switch versions / qualities post-import.
    Open

  • View Download History

    Audit what you downloaded and when.
    Review

  • Offline & Caching

    Learn cache location & offline behavior.
    Guide