Format guide: optional features

The short answerAn optional feature is an option a class picks from, such as a Warlock's invocation. Describe it to the Archivist Inquiry Assistant and approve what it suggests, or copy the closest one, paste your lines over it, press Save, and give it its own link name with Rename. It then joins that class's list in the Builder.

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

This page's example is Tide Caller, an invocation made up for the Drowned Coast.

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 your optional feature in a sentence.
  • Check what it suggests and press Approve. Your optional feature is in your Compendium and on your sheet.
For exampleGive my character a boon called Tide Caller: I can breathe water, and I have a Swim Speed equal to my Speed.

You can undo it. Can't see the owl? Turn on Archivist Inquiry Assistant in Settings.

Briar Fenn's character sheet with the Archivist Inquiry Assistant open over its right side. The box at the bottom holds the request for a boon called Tide Caller: breathing water and a Swim Speed equal to her Speed.

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 Tide Caller and found none, and it has a question: whether it is always on. Always on is picked and sent, and the next line says it is drafting the change.

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

The Archivist Inquiry Assistant's suggestion: Change Briar Fenn's sheet, adding Tide Caller and a Swim Speed, with an Approve button.

Your new optional feature is in the Compendium.

The Compendium's Optional features list showing Tide Caller from Homebrew, and its block: a boon that grants water breathing and a Swim Speed.

Briar Fenn's sheet with Tide Caller: a Swim Speed equal to her Speed.

Briar Fenn's sheet with Tide Caller: a Swim Speed equal to her Speed.

Change an existing one with the Archivist Inquiry Assistant

  • Open the Compendium, or a sheet that uses the optional feature, and press the owl.
  • Say which optional feature and what to change.
  • Check what it suggests and press Approve. Characters who use the optional feature change with it.
For exampleMake my Tide Caller option need Warlock level 5.

You can undo it.

The Archivist Inquiry Assistant's suggestion to change it, ready to approve.
Its suggestion, ready to approve.

Do it by hand: copy the option closest to your idea

  1. In the top bar, press Compendium.
  2. In the list on the left, press Optional features.
  3. In the search box, type a option closest to your idea. Here it is Devil's Sight.
  4. Press it in the list. When two rows match, pick the one with the rules you play by.
  5. Press Copy to my compendium.
The Compendium's Optional features list searched for Devil's Sight. Rings mark Compendium, the search box, the Devil's Sight row and the Copy to my compendium button.
Rings 1 to 5 match steps 1 to 5.
  1. Under To, press Homebrew. Every account starts with this compendium.
  2. Press Copy.
The Move or copy Devil's Sight window on Copy. Under To, the Homebrew compendium is picked and ringed, and a second ring marks the Copy button.
The built-in rules stay as they are. You work on your own copy.

Change it into your option

  1. In the list, press your copy: the Devil's Sight with Homebrew under Source.
  2. Above its card, press the ⋯ button.
  3. Press Edit.
The Optional features list with Devil's Sight from the Homebrew compendium ringed. The three dots button above its card is ringed and its menu is open, with Edit ringed.
Your own entries get this menu.
  1. Press in the Text box, select all of its text (Ctrl+A, or Cmd+A on a Mac), then paste these lines. Change the words to make it yours:
    Tide Caller
    name: Tide Caller
    edition: '2024'
    source: Homebrew
    feature_type: invocation
    description: You can breathe water, and you have a Swim Speed equal to your Speed.
    prerequisites:
      - kind: level
        min: 2
    available_to:
      - '[[SRD 2024/warlock]]'
    effects:
      - kind: speed-bonus
        mode: swim
        equal_to: walk
  2. Press Save.

The Preview beside the text draws the option again as you type. On a phone, Text and Preview are two tabs. Keep the spaces at the start of each line.

The Edit window with Tide Caller's lines in the Text box, ringed, and the Preview showing an invocation with its prerequisite and the classes that offer it. A second ring marks Save.
The Preview shows Tide Caller, and which classes offer it.

Give it its own link name

  1. Above its card, press ⋯, then Rename.
  2. Press Change beside Link name, and change the last part to your option's name.
  3. Press Rename.

A class lists options of the same link name once, so your copy needs its own to show beside the one you copied.

The Rename Tide Caller window with the Link name field ringed, ending in tide-caller, the old link name struck through under it, and a ring on Rename.
Nothing links to it yet, so nothing else changes.

Pick it in the Builder

  1. In the Builder, on your class's card, press Browse all on its list, then press your option.
The Eldritch Invocations window listing options A to Z with their sources, and Tide Caller ringed at the bottom, source Homebrew.
Its source says Homebrew.

The lines in an optional feature

Every line below is in the ready lines above, except uses.

LineWhat it doesWhat you can write
feature_typeWhich of a class's lists it joins. It must match the list's kind exactly.invocation, and the like
available_toWhich classes offer it.- '[[SRD 2024/warlock]]'
prerequisitesA level is checked. The rest are printed on its card.- kind: level, min: 2
effectsWhat it does on the sheet.kind: speed-bonus, mode: swim, equal_to: walk
usesA tracker on the sheet.max: 3, recharge: long-rest

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.

Which class lists can hold my option?

Any class whose level table has such a list, such as the Warlock's Eldritch Invocations. Copy an option from the list you want, so that its feature_type and available_to are right.

Will I see it on my phone?

Yes. Your homebrew stays in sync on every device you sign in on, along with your characters and their portraits.

Keep going