Compendium format guide

The short answerEvery entry in the Compendium is short text: a label, a colon and a value on each line, and the Archivist Inquiry Assistant can write and change it for you from a sentence. To see one yourself, copy an entry into your own compendium and press Edit. The Preview beside the text draws the entry as you type, so the fastest way to learn the format is to change a line and watch.

  • For players and DMs
  • 10 short steps
  • Updated 7 November 2026, for Archivist 1.4.0

This page's example opens the Poisoned condition from the SRD. The built-in rules stay as they are: you work on your own copy.

Make it with the Archivist Inquiry Assistant

  • Press the owl at the right edge of the screen to open the Archivist Inquiry Assistant. On a phone, press the owl beside search.
  • Describe the entry you want in a sentence: a class, a spell, an item, a monster or anything else.
  • Check what it suggests and press Approve. It is in your Compendium, ready to use.
  • To change an entry you already have, say what to change, and approve it the same way.
For exampleMake a condition called Seasick: Disadvantage on attack rolls and ability checks.

You can undo it. Each kind's guide below has an example to start from.

The Compendium's Conditions list with the Archivist Inquiry Assistant open over its right side. The box at the bottom holds the request for a condition called Seasick: Disadvantage on attack rolls and ability checks.

It may ask you something first. Pick an answer and press Send.

The Archivist Inquiry Assistant at work on the request. Its lines say it searched the Compendium for Seasick and found none, and it has a question: whether anything ends it early. A Short Rest ends it is picked and sent, and the next line says it is drafting the entry.

It shows what it adds. Nothing changes until you press Approve.

The Archivist Inquiry Assistant's suggestion: Seasick, a condition with its Disadvantage and its end, with an Approve button.

Your new condition is in the Compendium.

The Compendium's Conditions list showing Seasick from Homebrew, and its block: Disadvantage on attack rolls and ability checks, ended by a Short Rest.

The Compendium's Conditions list: Seasick from Homebrew.

The Compendium's Conditions list: Seasick from Homebrew.

Do it by hand: open any entry as text

  1. In the top bar, press Compendium.
  2. In the list on the left, press a kind of entry. Here it is Conditions.
  3. In the search box, type its name.
  4. Press it in the list.
  5. Press Copy to my compendium.
The Compendium's Conditions list searched for Poisoned. Rings mark Compendium, Conditions, the search box, the Poisoned row and the Copy to my compendium button.
Rings 1 to 5 match steps 1 to 5.
  1. Under To, press Homebrew.
  2. Press Copy.
The Move or copy Poisoned window on Copy. Under To, the Homebrew compendium is picked and ringed, and a second ring marks the Copy button.
Every account starts with this compendium.
  1. In the list, press your copy, the one with Homebrew under Source.
  2. Above its card, press the ⋯ button.
  3. Press Edit.

On a phone, Text and Preview are two tabs.

The Edit Poisoned window with the condition's lines in the Text box on the left and its card drawn in the Preview on the right.
Save waits until the text can be read.

The twelve kinds of entry

Each guide below has ready lines you can paste, and a table of the lines used most.

KindWhat it gives a characterThe guide
ClassHit points, saves, proficiencies, features by level, spell slots.Make a homebrew class
SubclassFeatures by level, inside its class.Make a homebrew subclass
SpeciesSpeeds, senses, traits and defenses.Make a homebrew species
BackgroundSkills, tools, ability increases, an Origin feat, equipment.Format guide: backgrounds
FeatEffects on the numbers, and its benefits.Make a homebrew feat
Optional featureAn option a class picks from, such as an invocation.Format guide: optional features
ItemCharges, attunement, bonuses and defenses.Make a homebrew magic item
ArmorArmor Class.Format guide: armor and weapons
WeaponAn attack row, with its to-hit and damage.Format guide: armor and weapons
SpellA row on the Spells tab, with its save or attack and its dice.Make a homebrew spell
MonsterA full stat block with rollable attacks.Make a homebrew monster
ConditionA chip on the sheet, with effects on the rolls.Track conditions and make your own

How a line works

Four rules cover almost everything you will type.

RuleExampleWhat it means
A label, a colon, a valuehit_die: d10One fact per line. A space follows the colon.
Spaces show what belongs to whatspeed:, then walk: 30 on the next lineTwo spaces at the start put a line inside the one above it.
A dash starts an item of a listclasses:, then - druidOne item per line.
Quotes keep a sentence wholename: "Rule of Three: The Tide"Use double quotes when your words hold a colon.

Questions

Save does nothing. What now?

Save waits until the text can be read, and a line over the Preview says what to fix, such as "Line 12 can't be read. Check its spacing and colons." Put the spaces back at the start of that line. If a sentence has a colon in it, put the whole sentence in double quotes.

Can I write an entry from nothing?

Copying the closest entry is the quickest way, because every line it needs is already there. Then replace what you want to change.

Can I share what I write?

Yes. Share homebrew with your party shows how to send a whole compendium as one file.

Keep going