Extensions

Extensions add features to Marginalia without changing the application itself. Twenty extensions come with Marginalia:

Extension	What it adds
Arc Outline	The arcs of the book and their chapters, with their state, in the sidebar; the model can write an arc for you.
Anthropic Claude	Anthropic's Claude models as an inference provider, over Anthropic's own API, with the thinking summaries shown as reasoning.
Author's Note	A note to the model, inserted into every generation of the book.
Beta Readers	Readers you invent (personas) and a chat with them about the book, alone or in a group.
Chapter Marker	Chapter titles in the story outline, from Markdown headings in the parts.
Character Tracker	The characters of the book with their relationships, and a map of them.
Gemma 4 tools fix	Makes function calling work with Gemma 4 models whose API wants another role for tool results.
Google Gemini	Google's Gemini models as an inference provider, over Google's own API, with the thinking summaries shown as reasoning.
Image Generator	Makes an image for a part of the story: the model writes the prompt, ComfyUI or an OpenAI-style images API draws it, you reroll and accept it.
Instruction Exporter	Copies the instructions, scene settings and characters of the story to the clipboard.
Lore Generator	Writes the content of a lorebook entry with the model, from the lore you already have.
Lorebook VCS	Revision history for lorebook entries.
Manga Generator	Turns parts of the story into a manga script of pages and panels, and into image generation tags.
Tools for the model	The Tools button of the generators: which tool suites (names, places) the model may use, and which of their categories.
Name generator	Names for the model to use instead of inventing them: about 1270 lists of names, as Markov chains.
Name provider	Real names for the model to pick from: forenames and surnames of about 100 countries, with the original spelling.
Place provider	Real places for the model to look up: cities, seas, bays, rivers, mountains and more with coordinates and countries, what is around a place and the distance of two.
Reviewer	Reviews of story parts written by the model - reader reactions, critique.
Side Query	A chat with the model about your book, next to the story.
Converter	A SillyTavern chat next to the story and turn details the model prepares from it, to rewrite the chat as a story; or the parts of an older book (from a backup or the book itself) with their instructions, to redraft it.
Chinese localization	Simplified Chinese as a language of the user interface.

Installing

Extensions are installed by an administrator for the whole Marginalia installation, in Admin → Extensions: they are JAR files, uploaded with Load Extension (.jar). See Managing extensions for the details.

Once installed, an extension is available to every user. An extension loaded while Marginalia runs shows up in windows opened afterwards: close and reopen a book (or reload the page) to see it.

The twenty extensions above are part of the Marginalia source code (marginalia/plugins) and are built separately; see the plugins README.

Extensions on a phone

The phone layout has its own classes, so an extension has to support it. Arc Outline, Author's Note, Beta Readers, Chapter Marker, Character Tracker, Instruction Exporter and Reviewer do; Side Query, Lore Generator and Lorebook VCS add nothing on a phone (see Using Marginalia on a phone). Name generator, Name provider, Place provider, Gemma 4 tools fix and Google Gemini have no screens of their own (Google Gemini only adds a provider to the model dialog, which a phone has as well), and Chinese localization is in the language selector of the phone menu. Extensions are installed from the Admin page, which a phone doesn't have.

Extension settings

Extensions with settings add a section to Settings → Extension Settings (the third tab of the Settings page). These settings belong to your account, like the rest of Settings, and are saved with its Save button.

Where extension data is kept

Extensions keep their data together with the data it belongs to - reviews with the story part, conversations with the book, revisions with the lorebook - so it is included in database backups. Whether it is also part of book backups and exports is described on each extension's page.

Uninstalling an extension doesn't delete its data: installing it again brings it back.