How to make a homebrew magic item

The short answerDescribe your magic item to the Archivist Inquiry Assistant and approve what it suggests, or copy the closest item and paste your text over it by hand. Then add it from your character's Inventory. The sheet tracks its charges and attunement, and its bonuses count once it is attuned.

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

This page's example is the Saltglass Charm from the Drowned Coast, Archivist's own sample homebrew.

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 magic item in a sentence.
  • Check what it suggests and press Approve. Your magic item is in your Compendium and in your inventory.
For exampleAdd a magic item called the Saltglass Charm to my inventory: it needs attunement, gives me a Swim Speed equal to my Speed, and has 3 charges that come back at dawn.

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

The character's sheet with the Archivist Inquiry Assistant open over its right side. The box at the bottom holds the request for a magic item called the Saltglass Charm: attunement, a Swim Speed equal to Speed, and 3 charges that come back at dawn.

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 Saltglass Charm and found none, and it has a question: whether to add it to the character's inventory now. Yes 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 the sheet, adding Saltglass Charm to the inventory, with an Approve button.

Your new magic item is in the Compendium.

The Compendium's Items list showing Saltglass Charm from Homebrew, and its block: a wondrous item needing attunement, with its Swim Speed and charges.

The character's inventory: Saltglass Charm, attuned.

The character's inventory: Saltglass Charm, attuned.

Change an existing one with the Archivist Inquiry Assistant

  • Open the Compendium, or a sheet that uses the magic item, and press the owl.
  • Say which magic item and what to change.
  • Check what it suggests and press Approve. Characters who use the magic item change with it.
For exampleGive my Saltglass Charm 5 charges instead of 3.

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 item closest to your idea

  1. In the top bar, press Compendium.
  2. In the list on the left, press Items.
  3. In the search box, type a item closest to your idea. Here it is Ring of Swimming.
  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 Items list searched for Ring of Swimming. Rings mark Compendium, Items, the search box, the Ring of Swimming 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 Ring of Swimming 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 item

  1. In the list, press your copy: the Ring of Swimming with Homebrew under Source.
  2. Above its card, press the ⋯ button.
  3. Press Edit.
The Items list with the Ring of Swimming 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:
    The Saltglass Charm
    name: Saltglass Charm
    edition: '2024'
    source: Homebrew
    type: wondrous item
    rarity: uncommon
    attunement: true
    description: A smooth shard of sea glass on a cord of braided kelp. While wearing it, you have a Swim Speed of 30 feet. As a Magic action, you can expend 1 charge to cast Water Breathing from it.
    bonuses:
      speed:
        swim: 30
    charges:
      max: 3
      recharge: dawn
      recharge_amount: 1d3
  2. Press Save.

The Preview beside the text draws the item 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 the Saltglass Charm's lines in the Text box, ringed, and the Preview showing a Wondrous Item, Uncommon, requiring attunement. A second ring marks Save.
The Preview shows the Saltglass Charm with its attunement.

Add it to a character

  1. On your character's sheet, press the Inventory tab.
  2. Press Add Item.
A character's Inventory tab with a ring on the tab's name and a second ring on the Add Item button.
The Inventory tab, on any character.
  1. In the search box, type your item's name.
  2. Press + Add on its row, then Done.
The Add Item list searched for Saltglass, showing the Saltglass Charm as a Wondrous Item, uncommon, with rings on the search box and the Add button.
Your homebrew sits in the same list as the SRD.
  1. Press your item's name in the Inventory, then press Attune.
The Saltglass Charm's row in the Inventory, Equipped and Attuned, with 3 of 3 charges. Below it, the item's card and the Unequip and Unattune buttons.
The row counts its charges: 3/3 ch.

The lines you will use most in a magic item

Add or remove these lines as your item needs them. The Compendium format guide lists every kind of entry.

LineWhat it doesWhat you can write
typeThe kind of item. A potion or a scroll is used up when used.wondrous item, ring, wand, potion, scroll
rarityColours the name and fills the rarity filter.common, uncommon, rare, very rare, legendary
attunementAdds the Attune button. Bonuses count only while attuned.attunement: true
bonusesAdds to Armor Class, saves, spell attack, spell save DC and speeds.ac: 1, saving_throws: 1, then speed: and swim: 30
resist, immuneDamage it protects you from, shown under Defenses.resist:, then - cold
condition_immuneConditions it protects you from.condition_immune:, then - charmed
chargesA counter on the item, and when it refills.max: 3, recharge: dawn, recharge_amount: 1d3
base_itemMakes it a weapon or armor, with its attack row or Armor Class.The link name of a weapon or armor

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 a DM give my item to a player?

Yes. In a campaign, the DM chooses Give an item from the campaign page's ⋯ menu. Give items to players shows each step.

How do my players get my item?

Press Manage compendiums, then Export beside your compendium, and send them the zip file. They press Import homebrew, choose Archivist files and drop it in. Share homebrew with your party shows each step.

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