How to manage assets in Logseq?

Updated 18 Oct 2026

•
On this page, asset doesn't refer to external files in the broad sense. It's used specifically to refer to a particular type of node.
•
Asset node
- •
  Asset: A term referring to a special type of node in Logseq. Asset nodes are tagged with the existing built-in tag (whose label is not displayed on nodes) #Asset, so these nodes can be viewed on the #Asset page.
- •
  An asset contains two pieces of information: a name and a file.
  - •
    The part that can be freely edited in an asset node is the name.
  - •
    The actual file can be located by right-clicking the node and selecting Show File in Folder.
- •
  Image and PDF files support built-in rendering, so the files themselves can be displayed directly within Logseq.
•
How to create an asset node
- •
  An asset node can be created in the following ways:
  1. 1.
    Drag and drop
  2. 2.
    Using the /Upload an asset command to upload a file
  3. 3.
    Clicking the + New button on the #Asset page
  4. 4.
    Clicking the Add assets button in an Asset-type property
  - •
    Asset nodes created using methods 3 and 4 are uploaded to the #Asset page
- •
  When an asset node is created using one of these methods, the selected file is copied to the assets folder within the graph folder.
- •
  The actual filename is then changed to the UUID of the asset node, while the original filename is used as the name of the asset node.
- •
  Therefore, all files associated with assets are located in the assets folder.
•
How to reference an asset node
- •
  Since an asset node is a node, it has a UUID.
- •
  Just like with any other node, it can be referenced by entering its UUID as [[UUID]].
- •
  Alternatively, it can be referenced using [[the name of the asset node]].
- •
  When an asset is referenced in this way, files that support rendering will be rendered in exactly the same way.
•
Links to external files
- •
  You can render supported external files by entering ![name](filepath) as a link to the external file.
- •
  However, this is simply a link to an external file and is not an asset node.
- •
  If you want to reference a file that has already been registered as an asset node, simply use [[asset node]].

Linked references 3

◌ Explore connections in Graph view

How to manage assets in Logseq?

Asset node

How to create an asset node

How to reference an asset node

Links to external files

Linked references 3