Skip to main content
The Sidebar Tabs API allows extensions to add custom tabs to the sidebar of the ComfyUI interface. This is useful for adding features that require persistent visibility and quick access.

Basic Usage

Tab Configuration

Each tab requires several properties:
The render function receives a DOM element where you should insert your tab’s content.

Icon Options

Sidebar tab icons use Lucide icon classes in the form icon-[lucide--<icon-name>] (e.g., icon-[lucide--compass]). The frontend generates these classes when it is built, so only the Lucide icons that the frontend itself uses are available. If an icon does not render, pick another icon, or define your own icon class in a stylesheet that your extension loads. PrimeIcons (pi pi-*) and Material Design Icons (mdi mdi-*) classes still render for now, but they are being phased out. Don’t use them in new code. See PrimeVue removal migration.

Stateful Tab Example

You can create tabs that maintain state:

Using React Components

You can mount React components in sidebar tabs:
For a real-world example of a React application integrated as a sidebar tab, check out the ComfyUI-Copilot project on GitHub.

Dynamic Content Updates

You can update sidebar content in response to graph changes: