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.
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.
Do it by hand: copy the item closest to your idea
Change it into your item
- In the list, press your copy: the Ring of Swimming with Homebrew under Source.
- Above its card, press the ⋯ button.
- Press Edit.
- 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 - 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.
Add it to a character
- On your character's sheet, press the Inventory tab.
- Press Add Item.
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.
| Line | What it does | What you can write |
|---|---|---|
type | The kind of item. A potion or a scroll is used up when used. | wondrous item, ring, wand, potion, scroll |
rarity | Colours the name and fills the rarity filter. | common, uncommon, rare, very rare, legendary |
attunement | Adds the Attune button. Bonuses count only while attuned. | attunement: true |
bonuses | Adds to Armor Class, saves, spell attack, spell save DC and speeds. | ac: 1, saving_throws: 1, then speed: and swim: 30 |
resist, immune | Damage it protects you from, shown under Defenses. | resist:, then - cold |
condition_immune | Conditions it protects you from. | condition_immune:, then - charmed |
charges | A counter on the item, and when it refills. | max: 3, recharge: dawn, recharge_amount: 1d3 |
base_item | Makes 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
- Give items to playersRight-click an item, Give to…; as DM, Give an item from the campaign page.
- Track inventory, bags and attunementAdd items, drag them into a bag, attune, and the sheet follows.
- Share homebrew with your partyExport your compendium as a zip; they bring it in with Import homebrew.
- Compendium format guideLet the Archivist Inquiry Assistant write entries, or learn the lines by hand.
- Make a homebrew spellDescribe it to the Archivist Inquiry Assistant, or copy a spell and change it by hand.







