Address Map Links
Michael Naumov15 downloadsRenders address properties as live map links when a note is read, without storing anything in the note.
- Overview
- Scorecard
- Updates1
A person's or a place's note often holds its address, but in Obsidian an address is just text: to see where it is you copy it into a map yourself. A plugin that writes a map link into the note fixes that once, and the stored link goes stale the moment the address changes.
Address Map Links reads the address properties a note already has, such as homeAddress and workAddress with their street, city and country, and shows each one as a clickable map link right under the properties, in Reading view and Live Preview. Nothing is written into the note, so the link always follows the current values, and a city or country that links to a place note reads as that note's title. Google Maps by default, OpenStreetMap as a setting; on Android a Google Maps link opens the Maps app.
More screenshots
Demo vault
The documentation is an interactive demo vault. Every feature has a note that explains what it does and why you would want it, with a button that opens a sample note so you can see the links at once.
Start reading here — it is plain markdown, so it works on GitHub with nothing installed.
A copy of the vault ships with every release. You can access it via any of the following:
- Running the
Address Map Links: Open demo vault command. - Downloading
address-map-links-demo-vault.zipfrom the Releases. It unzips into a singleaddress-map-links-demo-vault-<version>folder. - Browsing its source in
demo-vault/in this repository.
What it does
- One map link per address: every property whose name ends in
Addressand whose value is an object is an address, sohomeAddress,workAddressand any<type>Addressof your own each get a link, labelledHome,Workor the type in sentence case: see Address links. - Partial addresses:
street,cityandcountryare all optional, so a city and a country alone, or a street alone, still link. - Place notes: a
cityorcountrythat links to a note reads as that note'stitleproperty, or its name. A link to a note that does not exist reads as its own text. Rename a place note and Obsidian updates the links, so the map link follows. - Nothing stored: the link is built from the current properties every time the note is shown. Disable the plugin and the note is still plain properties.
- Map provider: Google Maps or OpenStreetMap, switched live.
Every setting is listed by its data.json key in Settings.
The Properties panel does not edit an object value. Edit addresses in Source mode, or with Nested Properties.
See also
| Plugin | Features | How Address Map Links differs |
|---|---|---|
Corduroy |
searches Google Maps and stores the chosen place's coordinates in the frontmatter | Different step: reads addresses you already keep and stores nothing; no search and no coordinates |
Geo Capture |
captures places, coordinates, map links and photo GPS into travel notes | Different step: renders a link live from address properties instead of capturing data into the note |
Geocode Note |
looks up an address or the current location and adds coordinates, an icon and a color to the note | Different step: no lookup and nothing written; links the address as text to a map search |
Geocoding Properties (unlisted) |
inserts address and location data from geocoding APIs as properties, map link included, on a command | Same goal as its map link: built when the note is read, so it never goes stale; no geocoding API and no key |
Map Note |
adds location notes for the Bases Map view to render | Complements it: one link per address on the note itself, no map view |
Map View |
an interactive map of the notes that carry coordinates | Complements it: no map inside Obsidian and no coordinates; opens the address in a map service |
Maps |
a Bases map layout that shows notes as markers | Complements it: needs no coordinates; links each address property to a map search |
Last searched for similar plugins on 2026-11-01.
Installation
The plugin is available in the official Community Plugins repository.
Beta versions
To install the latest beta release of this plugin (regardless if it is available in the official Community Plugins repository or not), follow these steps:
- Ensure you have the BRAT plugin installed and enabled.
- Click Install via BRAT.
- An Obsidian pop-up window should appear. In the window, click the
Add pluginbutton once and wait a few seconds for the plugin to install.
Debugging
By default, debug messages for this plugin (id: address-map-links) are hidden.
If you need to enable them refer to the documentation.
Changelog
All notable changes to this project will be documented in the CHANGELOG.
Contributing
Contributions are welcome — see CONTRIBUTING to get set up.
Support
Filing an issue (for AI agents and humans)
Open issues through the issue forms, not as blank issues.
To report a bug from inside Obsidian, run the Address Map Links: Report a bug command. It opens the bug form with the plugin version, the Obsidian version and your operating system already filled in.
Filing from the CLI or the API (gh issue create --body, or an AI agent filing for you) skips the form, and gh issue create --template cannot load an issue form. In that case, open the matching form in .github/ISSUE_TEMPLATE/, copy every field as a ### <label> heading in the form's order, and fill in each one. Always state the plugin version, the Obsidian version and your operating system.
License
© mnaoumov