Skip to content

Official Smart Plugins site

Smart Plugins are independent third-party plugins for Obsidian. Smart Connections is the flagship plugin.

Exploring the Connections view

The Connections list is the core Smart Connections experience: a ranked list of notes or blocks related to what you are looking at right now.

Use it when the current note is the anchor:

What else in my vault is related to what I am looking at right now?

If your vault has ever felt like:

"I know I wrote something about this, but where is it?"

Connections is the answer.

It surfaces related context so you can preview, open, or link useful notes without organizing first.

For the trust boundary behind local retrieval, see WHY local embeddings and Smart Environment settings.

First win: preview -> drag/open
  1. Open one real note with meaningful text.
  2. Open the Connections view.
  3. Preview one promising result before trusting it.
  4. If it helps, drag it into the note or open it.
  5. You know it worked when one useful related note from your own vault becomes actionable.


What this solves

Connections is for:

Why it works without perfect organization

Connections adds value before your vault is perfectly tidy:


Quick start

  1. Open the note you are actively working on.
  2. Open the Connections view.
  3. Scan the top results.
  4. Hold Cmd/Ctrl while hovering over one result to preview it.
  5. If it is useful, drag it into your note or open it.

A good first artifact is:

## Related
- [[...]]

If your note is empty or very short, open a richer note before judging results.

If this is your first run and results look empty, check Smart Milestones or Smart Environment settings.


Connections vs Lookup

Use the surface that matches the anchor.

Need Use Why it fits
Current note -> related ideas Connections list The current note is the anchor.
Question -> semantic search Smart Lookup The query is the anchor.
Exact phrase, regex, filename, heading, or tag Obsidian search You need lexical matching.
Landscape -> clusters and neighborhoods Smart Graph You need the shape of a topic, not just a list.
Reusable set -> AI-ready context Smart Context You found useful notes and now need to package them.
Duplicate cleanup -> review Smart Dedupe You need to review repeated blocks or near-duplicates before changing notes.

Use this rule:

Current note -> Connections.
Question -> Lookup.
Exact phrase -> Obsidian search.

Connections is not a replacement for exact search.

It is for the moment when related material should surface from the note you are already working in.

Related notes are not automatically duplicates.
Use Dedupe when repeated material needs review.


Core moves after the first proof

Do the first proof first: preview one result, then drag or open it.

After that, these continuation actions become useful.

1) Drag to create links

Drag any result into an open note to insert an Obsidian link.

Use this to build link trails while you write, not as a separate cleanup session.

2) Preview before you commit

Hold Cmd/Ctrl while hovering a result to open Obsidian's native Hover Preview.

Use this to confirm the note is actually relevant before switching context.

3) Pause to hold an anchor steady

Connections updates automatically when you change notes unless paused.

Use Pause when:

If the list feels stuck, make sure Play is active so it refreshes.

4) Copy as a list of links

After one useful result, copy the results as a clean list of Obsidian links.

Use this for:

5) Send results to Smart Context

After first proof, send results to Smart Context when you want to turn strong matches into a reviewable AI-ready bundle.

Workflow:

  1. Pause on your anchor note.
  2. Send results to Smart Context.
  3. Remove noise and reorder what matters.
  4. Copy the final bundle and ask for an outcome.

Related:


Understanding the list

Play/Pause updates

Play/Pause controls whether the list updates as you change notes.

Use Pause when:

If the list feels stuck, make sure Play is active so results can refresh as you switch notes.

Score

Score is a ranking signal, not a grade.

Higher scores generally mean "more related", but treat the score as a clue to inspect, not truth to trust.

Practical rules:

  1. Compare scores within the same list, not across different notes.
  2. Score ranges vary by vault content and embedding model.
  3. Preview or open results before trusting them.
  4. If results feel broad or noisy, tune Sources vs Blocks, limits, and filters in the settings.

The score algorithm uses cosine similarity by default. Pro users can choose additional scoring and ranking options.

Expand/collapse

Expand a result to preview content without opening the note.

Use it to scan faster and avoid context switching.

Click behavior

Clicking a result follows Obsidian's default link behavior:


Managing noise: Hide and Pin

As your vault grows, some connections will be technically related but not useful right now.

Hide

Hide removes a noisy result from the list.

Use hide when:

Pin

Pin keeps an item visible as a stable reference.

Pinning is useful when:

Note

In Connections Pro, pinned and hidden signals can also shape ordering for some algorithms.


List controls

The menu contains controls that turn scanning into action.

Refresh

Refresh recomputes results for the current note.

Use it when:

Send to Smart Context

Send results to Smart Context is the fastest way to turn your Connections list into high-quality AI context grounded in your own vault.

A practical workflow:

  1. Pause the list on the note you are working on.
  2. Send results to Smart Context.
  3. Remove anything noisy and reorder what matters.
  4. Copy the final context to your AI tool.

Learn more:

Copy as a list of links

Copies the results as a simple list of Obsidian links.

Use it to:

Quick controls cheat sheet

Control What it does When to use it
Play/Pause Stop or resume automatic updates Keep one anchor note steady while you browse.
Refresh Recompute results After major edits or settings changes.
Copy links Copy ranked links Add a clean related list to a draft.
Send to Context Send results to Smart Context Build AI-ready context fast.
Hide/Pin Remove noise or lock essentials Reduce clutter or keep key references visible.

Connections displays: same loop, different surfaces

The default Connections list lives in the sidebar. The same preview -> drag/open loop can appear in several surfaces.

Core includes the sidebar/list, Footer connections, Smart Lookup, and mini-graph behavior in the list view.

Pro adds inline discovery, Bases workflows, advanced result rendering, filters, scoring/ranking, larger-vault performance workflows, and Smart Graph handoff/additional graph features.

Surface Status Best when Main strength Learn more
Sidebar list Core You want the default note-first workflow Best all-around preview -> drag/open loop This page
Footer connections Core You want suggestions while drafting or on mobile/no-sidebar workflows Keep related notes available at the bottom of the note Footer connections
Mini-graph in list view Core You want a quick visual cue inside the Connections result surface Adds spatial context without leaving the list workflow Connections settings
Smart Lookup Core You have a question first, not an anchor note Query-first semantic discovery Smart Lookup
Inline connections Pro You want relevance beside the exact paragraph you are editing Retrieval stays closest to the writing surface Inline connections
Bases integration Pro You want to sort or score a collection by relevance Turns relevance into prioritization Connections in Bases
Smart Graph handoff / additional graph features Pro You need topic shape, clusters, or neighborhoods beyond the list Graph-first landscape exploration Smart Graph

Connections mini-graph/list behavior is part of the Connections result surface.

Smart Graph is the Graph-first landscape workflow for clusters, neighborhoods, and topic shape.

Footer connections

Footer connections place a Connections panel at the bottom of your note so related links are available while you write.

Footer connections are included in Smart Connections Core.

This is especially useful when:

Learn more:
Footer connections


Mini-graph and Smart Graph

Core includes mini-graph behavior in the Connections list view. Use it as a quick visual cue while staying in the note-first Connections workflow.

Use Smart Graph when you need the shape of a topic, clusters, neighborhoods, and bridge notes beyond a ranked list.

Pro adds Smart Graph handoff and additional graph features, including opening Connections results as a scope in Smart Graph Pro.

Learn more:

Inline connections (Pro)

See Connections appear alongside content while you write, right inside the editor.

Learn more:
Inline connections


Pick your first workflow

A) Writing: ground a draft in your existing notes

B) Research: build a meaning-ranked reading trail

C) AI work: assemble grounded context fast

D) End-of-note linking pass


When results are wrong

Do the minimum fix that matches the symptom.

Symptom Try first
Results are too broad or noisy Lower result limits, switch Sources vs Blocks, or add include/exclude filters.
Results are not updating when you change notes Make sure you are not paused.
Relationships feel stale after edits Use Refresh.
You actually want query-first search Use Smart Lookup instead.
You know the exact word, tag, heading, or regex Use Obsidian native search.
You want connections per paragraph inside the editor Enable Inline connections.
Similar results look like repeated work Use Smart Dedupe to review likely duplicates.
You need topic shape, not a list Use Smart Graph.

If you suspect indexing is stale, check Smart Environment settings.


Local retrieval boundary

For Core semantic retrieval:

  1. Smart Environment prepares local embeddings after indexing.
  2. Connections compares the current note to the local index.
  3. Results can appear without uploading your vault for the Core retrieval path.

Provider-backed workflows are separate.
If you use a configured cloud provider, Smart Chat, Generate, or another provider-backed workflow, that provider receives the context you explicitly choose to send through that workflow.

Related:


FAQ

How do I refresh or re-embed a specific note?

If results feel stale after major edits, use Refresh in the Connections view first.
That updates results for the current note without forcing a full rebuild.

If you changed embedding models or want a vault-wide reset, use Smart Environment settings.
If you are still on first run, verify indexing in Getting Started.

Does Smart Connections replace backlinks?

No.

Smart Connections complements backlinks.
Backlinks show links you already made.
The Connections view surfaces related notes even when no link exists yet.

Use it to find relevant notes, then drag results into your note to turn relevance into links.
If you want query-first discovery instead of note-first suggestions, use Smart Lookup.
For the flagship overview, see Smart Connections for Obsidian.

Do I need to reorganize my vault first?

No.

That is one of the main reasons to use Connections.
It helps you discover relevant notes before your vault is perfectly linked, tagged, or foldered.

Start with one working note, preview one result, and turn the best match into a link or opened note.
As you use it, your vault naturally gets easier to navigate because relevance becomes structure.

Does Smart Connections replace exact search?

No.

Use Connections when the current note is the anchor.
Use Lookup when a question is the anchor.
Use Obsidian search when the exact word, file, heading, tag, or regex matters.

Are related notes duplicates?

Not necessarily.

Related notes can be useful neighbors.
Use Smart Dedupe when you need to review likely repeated blocks or near-duplicates before changing notes.

Related pages