$ get started with the Obsidian Attachment Placement plugin
This page serves as a comprehensive guide to setting up and using the Obsidian Attachment Placement plugin. Whether you're new to Obsidian or just looking to optimize your workflow, this guide will walk you through everything you need to know to get the most out of this powerful plugin.
To get started, you must first install the Obsidian Attachment Placement plugin from the Obsidian community plugins directory. Once installed, you can access the plugin settings to customize how attachments are placed within your notes.
The plugin allows you to define placement rules which determine where new attachments should go based on where you are currently working within your vault.
Fallback Destination: This is the default location where attachments will be placed if no other rules apply. You can set this to a specific folder in your vault, or leave it blank to use the default behavior.
Fallback Depth Limit: This setting determines how far up the folder hierarchy the plugin will look for applicable rules before falling back to the default destination. A depth limit of 0 means it will only check the current folder, while a higher number allows it to check parent folders as well.
Notifications: This setting allows you to enable or disable popup alerts.
Reset Settings: This is a button that will reset all plugin settings back to default.
Clear All Rules: This is a button that will clear all placement rules that are defined.
Consider the following vault structure:
Obsidian Vault
├─ 00 - Attachments
│ └─ Programming
│
├─ 01 - Long Term Notes
│ └─ Programming
│
├─ 02 - Active notes
│ ├─ Python
│ └─ Software Development
│
└─ 03 - School
├─ CS240 - Data Structures
│ └─ Queue.md
└─ CS261 - Computer Systems
If you are currently editing a note in the Queue.md file and add an attachment,
the plugin will first check for placement rules in the Queue.md file.
If none are found, it will check the parent folder CS240 - Data Structures,
then School, and so on up the hierarchy until it finds a rule or reaches
the root of the vault. If a rule is found at any level, the attachment will be placed
according to that rule. If no rules are found after reaching the root, the attachment
will be placed in the fallback destination specified in the plugin settings.
To the right is a screenshot of what the plugin settings would likely look like for this overly simple example vault that only has programming related notes.
