Export Output

When you export your sheet, Sheet Architect generates a set of files ready for your target VTT. The export output described below is for Roll20. Other VTT targets will produce different file formats when support is added.

Here is what each file contains and how to use them.

Generated Files

sheet.html

This is the core of your character sheet. It contains your entire layout converted into the HTML markup that Roll20 understands. Specifically:

• Component elements with Roll20 attribute bindings -- every input has a name="attr_..." attribute that tells Roll20 where to store the value
• Repeating sections wrapped in <fieldset class="repeating_..."> tags, which is Roll20's format for lists of items (inventory, spells, features, etc.)
• Roll buttons with their dice formulas, ready to send rolls to chat when clicked
• Roll template HTML embedded at the end of the file, defining how roll results appear in chat
• Sheet worker scripts generated from your logic graphs, wrapped in <script type="text/worker"> tags. These are the JavaScript functions that handle calculations (like computing an ability modifier from a score, or updating AC when armor changes)
• Translation key references using Roll20's data-i18n attributes for any translatable text

sheet.css

This file contains all your visual styling:

• Design tokens defined as CSS custom properties in a :root block at the top
• All styles from the Style Editor, exactly as you wrote them
• Scoping rules that prevent your styles from affecting Roll20's own interface

The CSS is ready to paste into Roll20 without modification.

sheet.json

This file contains metadata and translation strings:

• Sheet name and author information
• Translation keys -- if you used translatable text in your components, this file maps translation key names to their default text values. This allows community translators to provide versions of your sheet in other languages.

For sheets submitted to the Roll20 community repository, this file also includes the manifest information that Roll20 uses to list and categorize your sheet.

Uploading to Roll20

The quickest way to get your sheet onto Roll20 is through a game's custom sheet settings. For full details on each method, see Using Your Sheet.

Here are the basic steps for a custom game upload:

1. Open your Roll20 game and go to Settings (the gear icon) then Game Settings
2. Scroll down to Character Sheet Template and select Custom
3. You will see three tabs: HTML Layout, CSS Styling, and Translation
4. Open your exported sheet.html file in a text editor, select all the contents, and paste them into the HTML Layout tab
5. Open your exported sheet.css file, select all the contents, and paste them into the CSS Styling tab
6. If your sheet uses translation keys, open sheet.json and paste its contents into the Translation tab
7. Click Save Changes

After saving, open any character in your game to see your sheet in action.

Testing Your Export

Before sharing your sheet with players, test it thoroughly:

• Open a character and verify all fields appear correctly
• Enter values in inputs and confirm they save (close and reopen the character)
• Check calculations -- change an ability score and verify that modifiers, skills, and other derived values update
• Test roll buttons -- click roll buttons and verify the chat output looks correct, especially if you have custom roll templates
• Try repeating sections -- add and remove rows in repeating sections (inventory, spells, etc.) and confirm they work
• Check tab switching if your sheet uses tabs

For Roll20's official guide on uploading sheets, see Building Character Sheets -- Uploading Your Sheet.