Frequently Asked Questions
General
What's the difference between this and Obsidian's built-in graph?
Obsidian's graph shows backlinks between notes. Nexus Properties shows frontmatter-based relationships with automatic bidirectional sync, multiple view modes, color rules, filtering, and zoom previews.
Why use frontmatter relationships instead of backlinks?
- Explicit structure — Define clear parent-child hierarchies, not just loose links
- Bidirectional sync — Set once, both sides update automatically
- Typed relationships — Distinguish between parent, child, and related
- Queryable — Filter and search based on relationship properties
Relationships
How do I break a relationship?
Delete the relationship from one file's frontmatter — the reverse is removed automatically. Or right-click an edge in the graph → "Remove Relationship". See Context Menus.
My relationships aren't syncing
- Check directory scanning includes both files
- Verify property names match your frontmatter
- Use wiki link format:
"[[note name]]" - Run a full rescan to rebuild relationships
Graph
Why isn't my file showing in the graph?
- File must be in an indexed directory
- File needs at least one relationship (
Parent,Child, orRelated) - Check that filters aren't hiding it
- Ensure the view mode matches your relationship type
My color rule isn't working
- Check expression syntax — must be valid JavaScript
- Property names are case-sensitive
- Verify the rule is enabled and check rule order (first match wins)
- Confirm the property exists in frontmatter (use tooltips to verify)
Node Creation
Where are new nodes created?
In the same folder as the source file. See Node Creation for details.
What is a Zettel ID?
A unique timestamp identifier (YYYYMMDDHHmmss) assigned to each new node. Configured in Settings.
Get Help
- Troubleshooting Guide — Common issues and solutions
- GitHub Discussions — Community Q&A
- Report a Bug — File an issue