Plugin panels
A panel is a piece of UI that a plugin contributes to your workspace — its own view alongside your notes, built through Altretta's documented render protocol. A task dashboard is a good example: a plugin can surface your open tasks as a live panel instead of a static note.
What panels are
Beyond adding commands and workflows, a plugin can bring its own panel into Altretta's workspace. It sits among your other views and can present information drawn from your vault — a dashboard, a summary, a specialized editor for a kind of content, and so on.
Panels render through a documented render protocol, so a plugin describes what its panel should show and Altretta draws it inside the app in a consistent, predictable way.
Example: a task dashboard panel can gather the tasks across your notes and show them in one place, updating as your notes change — something a plain Markdown note can't do on its own.
Panels play by the same rules
A panel doesn't get special privileges. It lives inside the same protections as the rest of the plugin:
- It runs in the sandbox — no unfettered access to your filesystem, network, or system.
- It's permission-scoped — if the panel needs to read your note contents to display them, the plugin must have requested that permission, and you must have granted it.
- It renders through the documented protocol, rather than injecting arbitrary code into the app.
A panel that shows information from your notes needs the permission to read them. As with everything else, you'll have seen and approved that when you enabled the plugin — see How plugins stay safe.
Using a panel
Once a plugin that provides a panel is installed and enabled, its panel becomes available in your workspace. You open, arrange, and close it like Altretta's built-in views. Disabling the plugin removes its panel; re-enabling it brings the panel back.
Related
Plugins
The overview of Altretta's signed, sandboxed plugin model.
Install & manage plugins
Get a plugin that provides a panel from the Hub, and enable it.
How plugins stay safe
A panel obeys the same sandbox and permission scopes as its plugin.
Developing a plugin
Building a plugin that contributes a panel? Start here.
Workspace
How panes, docks, and views — including plugin panels — are arranged.
Glossary
Render protocol, panel, sandbox, and permission scope, defined.