Smart Plugins
Install Core and Pro plugins, understand loaded and installed states, and track first-use progress from one Smart Plugins reference. Pro capabilities remain visible beside the Core path.
In this guide
Install and update Smart Plugins in Obsidian
The Smart Plugins Store is the in-app catalog and lifecycle surface for Core and Pro Smart Plugins. Account, entitlement, installed edition, loaded runtime, and update state determine each row action.
The Smart Plugins catalog keeps account access, plugin rows, and current lifecycle controls in one settings surface.
Open the Smart Plugins Store
Open Browse Smart Plugins from Smart Environment settings, a Smart Plugin settings page, the Smart Environment status-bar menu, or the Command Palette.
Read the account row
The account row shows the sign-in action before Pro installation or update controls become available.
The account row shows signed-in, signed-out, invalid-account, and subscription display states. Pro install and update access follows the account's current Pro access.
Does the displayed subscription expiry decide access?
No. Current Pro access decides whether Pro installation and updates are available.
Browse while signed out
Signed-out users can browse the catalog and install eligible Core plugins. Sign in before installing or updating Pro plugins.
Why can I browse Pro but not install it?
Browsing is available while signed out or without access. Pro installation and updates require current Pro access.
Recover from an invalid account token
When the saved account token is rejected, the Store keeps the local credential and shows recovery actions such as Refresh and Logout. The catalog can still fall back to signed-out browsing.
Understand Core and Pro rows
Related Core and Pro editions can appear in one grouped row. The row shows the installed edition, available update, account access, and the next valid action.
Browse Official and Experimental sections
Official plugins appear in the main catalog. Plugins labeled experimental appear in a separate Experimental section.
Install a Core plugin
Select Install or Install Core for an available Core plugin. A new installation is enabled after the plugin files are installed.
Install a Pro plugin
Select Install Pro when the account has access. Installing Pro over an existing Core edition can require an Obsidian reload before the new edition is active.
Update installed plugins
Update appears when a newer version of the installed edition is available and, for Pro, the account has current access. Updating preserves whether the plugin was enabled.
Enable
Enable appears when a plugin is installed but disabled.
Reload after an install or update
Reload appears when newer plugin files are installed but the current Obsidian session has not loaded them yet.
Why does the Store show Reload?
Newer plugin files are installed, but the current Obsidian session has not loaded them yet.
Open details and release information
Use the details action to open the best available documentation or release page for the selected plugin edition.
Current Pro update behavior
Smart Environment Pro can check for and apply eligible installed Pro updates when the environment loads or the Pro plugin state is refreshed.
Are eligible Pro updates applied automatically?
Yes. Smart Environment Pro can apply eligible installed Pro updates during environment load or a Pro-plugin refresh.
Interpret installed and runtime states
A row can indicate install availability, Core installed, Pro available, disabled, installed, active, update available, reload required, or an outdated Smart Environment. Installed files and the loaded runtime are separate states.
Troubleshooting the Smart Plugins Store
Refresh after account changes, confirm Pro access, reload when new files are not active, check the installed edition before replacing Core with Pro, and update Smart Environment when required.
Track Smart Plugin progress with Smart Milestones
Smart Milestones is an in-app reference checklist for supported first-use actions. This page documents checklist behavior; narrative Getting Started pages own the first-run journey.
The current Milestones checklist groups setup and feature actions in a readable progress view.
Open Smart Milestones
Milestones opens from the Smart Environment status-bar menu.
Open Milestones from the Smart Environment status-bar menu.
Understand checklist groups
Milestones are grouped by Environment, Connections, Lookup, Context, Chat, and Pro features. Complete the groups that match the workflow you are adopting; the checklist is not mandatory homework.
Do I need to complete every milestone?
No. Complete only the milestones that support the workflows you are adopting.
Read progress indicators
The modal shows overall progress and a completed/total count for each group. A checked item means Smart Environment detected the required action or installed-plugin state.
Understand optional Pro milestones
Pro milestones are labeled separately. They remain visible so the available workflow is understandable, but they require the corresponding Pro plugin or account access.
Achievement notifications
A completed milestone can appear as an actionable in-app notification with a path back to the checklist.
Completing a milestone can show an achievement notification after Obsidian becomes idle. Notifications appear one at a time and only while the app is visible.
Why was there no notification immediately?
Notifications wait for idle input, require Obsidian to be visible, and do not overlap.
Open documentation from a milestone
Select a milestone to open the documentation for that exact action. Use the link when the checklist tells you what to try but you need the current controls or recovery steps.
How milestones are completed
Most milestones complete when the corresponding action is detected. Installation milestones can also complete from the installed plugin state.
Why did an install milestone complete automatically?
Installation milestones can be detected from the installed plugin state.
Troubleshoot an unchecked milestone
- Repeat the action once in the same Obsidian window.
- Reopen the Milestones modal.
- Confirm prerequisites such as source import and embedding readiness.
- Confirm the action exists in the installed plugin release.
Milestones by feature family
Environment tracks readiness; Connections and Lookup track semantic-result actions; Smart Context tracks create, copy, and reuse actions; Smart Chat tracks saved or completed threads; Pro groups remain optional.