Skip to content
Actions for Obsidian icon Home Actions for Obsidian 2024.2.1 › Actions

Actions for Obsidian › Actions › Get Attachment Folder Path

Returns the file system path for the attachments folder in a given vault.

This is a macOS-only action.

Parameters

Vault

The vault to work in.

Type: Vault reference

Omit home folder prefix

By default, the result of the action is the absolute file path starting from your Home folder. If you need the full absolute file path, i.e. starting from the root of the volume, uncheck this box. Example:

  • checked: /Documents/Obsidian Vaults/Workbench/media
  • unchecked: /Users/YourUserName/Documents/Obsidian Vaults/Workbench/media

Type: Boolean (YES/NO)

Return Value

Text

Examples

I want to copy a file to the attachment folder in your Obsidian vault, so I'd use this action to get the file system path for the vault's attachment folder. I keep the "Omit home folder prefix" option enabled, because for this example only the absolute path from my Home folder is needed.

Next, I specify or select a file. This file could be anything, but for the sake of this example, I use a fixed file on my desktop, named borger.jpeg.

Finally, I use Shortcuts's built-in "Save File" action, passing the aforementioned file as the first argument (the source) and my Home folder as destination (by clicking the parameter and selecting it in the file dialog). I'll disable the "Ask Where To Save" option which allows me to enter a subpath — and here I use the output of the "Get Attachment Folder Path" action.

Screenshot of the workflow

When run, the "Save File" action will use the file name of the passed-in file, and save it under the following path: {Home folder}/{Vault attachment folder path}/{file name}. In this example, this means:

  • Home folder: /Users/czottmann
  • Vault attachment folder path: /Documents/Obsidian Vaults/Testbed/media
  • File name: borger.jpeg

… so the file is saved in /Users/czottmann/Documents/Obsidian Vaults/Testbed/media/borger.jpeg , i.e. in the attachment folder of my vault "Testbed".