Skip to main content

Ribbon actions

The sidebar on the left side of the Obsidian interface is mainly known as the ribbon. In addition to system operations, such as opening the preferences or another vault, the ribbon can also host actions defined by plugins.

To add an action to the ribbon, use the addRibbonIcon() method:

main.ts
import { Plugin } from "obsidian";

export default class ExamplePlugin extends Plugin {
async onload() {
this.addRibbonIcon("dice", "Print to console", () => {
console.log("Hello, you!");
});
}
}

The first argument specifies which icon to use. For more information on the available icons, and how to add your own, refer to Icons.