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](/_astro/afo-get-attachment-folder-path.EEIcfmQL_1zGq41.webp)
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”.
Related Links
- Search the Actions for Obsidian community forum for "Get Attachment Folder Path"