Skip to main content

Elements

In short

Groups arrange the page; fields, lists, and trackers hold values; buttons roll dice and change them. A group is a section or a card, a list holds entries or table rows: its Kind switches between them. Groups split into up to four columns and can link to a documentation page.

Full pages and briefs​

Every page is a Full page or a Brief, chosen under Page kind next to the page's name. A full page is built from sections and cards; a brief is the short page read at the table, built from brief blocks and fields only. The kind decides how every field looks: on a brief fields are compact and ratings show short labels, on a full page everything is full size.

  • Switching the kind converts the page: a full page's cards become brief blocks (a section with loose fields gives them a block of their own), and a brief's blocks become cards in one section named after the page. Every field keeps its place in reading order, and Ctrl+Z undoes the switch.
  • Pasting works the same way: a card copied from a full page arrives on a brief as a brief block, and a brief block arrives on a full page as a card. A brief block pasted into another block gives it its fields.
  • The editor offers only what the page can hold: Group on a full page, Brief block at the top of a brief.
  • Edited shipped pages keep the kind of the page they edit.

Kinds of groups and lists​

A Group holds other elements, as a Section or a Card. A List holds what readers add one by one, as Entries or a Table. The Kind at the top of Content switches between them; the outline and the page name both, such as "Group · Section" or "List · Table".

  • Section ↔ Card keeps the title, the contents, the columns, and the documentation link. A card made from a section can still be folded.
  • Entries → Table makes the entry field the first column. Table → Entries makes the first column the entry field; other column types become text, and the other columns are removed after you confirm.
  • What one kind has and the other lacks (a card's hidden title, preset entries, row limits) comes back when you switch back before closing the editor.
  • Table is not offered for lists the game keeps and for lists that suggest catalog entries.
  • Entries and table rows are stored differently. When documents already hold values of the earlier kind, Save names the list and asks first; the values stay stored and show again if you switch back.

Sections​

A section is a large block with a heading and a colored bar. Readers fold and unfold it; Starts collapsed keeps it folded until the reader opens it once (the choice is then remembered). Neighbouring sections alternate the bar's color by themselves.

ExampleDrawn by the real interface from example data; nothing here is saved.

Cards​

A card is a titled box inside a page or section. Show title hides the heading while keeping the card; Collapsible lets readers fold it (only with a visible title).

ExampleDrawn by the real interface from example data; nothing here is saved.

Brief blocks​

A brief block is the only group of a brief: a small heading over a line, no box, and columns that follow the width of the area the page is drawn in (a phone, a window beside others, a full screen) instead of the browser window. Cells placed in columns stay three across down to a narrow area, then fold into one column. Use one block for each clearly different kind of field (attributes apart from skills), not one per field. A block can hide its title, fold, start folded, and link to documentation; make a block fold only when it grows without bound (weapons, powers) or is rarely needed in play (notes).

ExampleDrawn by the real interface from example data; nothing here is saved.

Sections, cards, brief blocks, fields, built-in parts, and buttons take a Documentation link under Visibility and help: a ? next to the heading or label. The link sits beside a section's fold button, so opening help leaves the section open or closed as it was. For a page of this site a click shows that part of the page in a card beside it, in the reader's language, with Open the page; Ctrl or Cmd click and a middle click open the page in a new tab, as does an external link. Two forms are accepted:

  • A page of this site's documentation: the address from the browser after the domain, starting with /docs/, for example /docs/wod-v5/rules/dice-pools#reading-the-dice. The part after # jumps to a heading: open the page, hover a heading, and copy its link. Readers get the page in their own language — write the English address and Russian readers land on the Russian page.
  • An external page: a full address starting with https://, for example a wiki article.

Anything else — an address without /docs/, http://, or another scheme — is listed as an issue and is not shown on the page.

On a full page, only Markdown text and Mentioned in fields automatically have a ? explaining their syntax or incoming links, including on pages you create yourself. Other elements are explained here in the template editor guide. Your own Documentation link takes its place. Where Hide help is offered under Visibility and help, turn it on to hide the automatic help for that field; its own documentation link still shows. A brief shows only the links you set yourself.

ExampleDrawn by the real interface from example data; nothing here is saved.

Columns​

Pages, sections, and cards lay out their elements in 1 to 4 Columns. With Equal column widths off, each column gets a width: widths are proportional, so 2 and 1 make the first column twice as wide. Without pinned elements, elements fill the columns in order. Column in parent pins an element to one column; once any element of a container is pinned, the elements left on Auto stack in the first column. Spans columns stretches an element over 2 to 4 columns — a wide field beside a narrow one, or a full-width row; spans work while no element of the container is pinned. On a phone every container shows one column. An empty column shows a drop zone in the editor.

ExampleDrawn by the real interface from example data; nothing here is saved.

Fields​

A field holds one value. Its Label is shown next to it (Show label hides it), Help text explains it on hover, and Required marks it for the reader without blocking anything. Label position puts the label Above the value in small grey type, or Beside the value in the larger type of the sheet's attribute rows; ratings and derived values start beside, other fields above. An image always keeps its label above: the picture and its upload controls need the whole width.

TypeWhat the reader gets
TextA line of text, or a larger box with Multiline; a Placeholder shows while it is empty.
NumberA number kept within Min, Max, and Step; arrow keys step it.
ToggleA dot: transparent when off, filled when on.
ChoiceOne option from a list, or several with Allow multiple values; Hide unselected options shows only the chosen ones until the reader opens the list. A choice can take its options from a catalog.
RatingA row like the sheet's attributes: dots or a number from Min to Max; see Ratings.
ResourceA current value and a maximum, such as a pool of points. Display: Tracker draws it as one row of boxes, as for built-in pools, up to 20 boxes.
Derived valueA number computed by a formula; readers cannot type into it.
ImageA picture from the device or an https:// address.
Markdown textA long text with headings, lists, tables, callouts, rolls, and pictures; see Markdown text.
Mentioned inThe documents whose markdown links to this one; see Mentioned in.
Document referenceLinks to other documents of the allowed types; readers open them from the field; see Document references.
TrackerBoxes the reader marks by level, for health, stress, or any other burden; see Trackers.
ExampleDrawn by the real interface from example data; nothing here is saved.

Images​

A standalone image field holds one picture on the sheet, chosen from your device or shown from an HTTPS web address. Unlike a picture inside Markdown text, it has its own upload, address, and removal controls.

Press Upload image and choose a file from the device (up to 10 MB); it is resized and saved in this browser. Or paste an https:// picture address in Image URL, then press Enter or leave the field to apply it. An unavailable or insecure source shows a message.

Upload another picture or enter another address to replace the image. Remove image (×) clears the field; clearing the address text alone does not remove the existing picture.

Device uploads stay on this device and are not included in document exports; keep the original file to upload again elsewhere. An image by address keeps its address in the export and loads from that website, so it needs to remain available. See export and import.

Markdown text​

A long text written in markdown, like a note: readers see it as a page and press Edit to change it. Starting height (lines) sets how tall its text box opens. On a brief it is read-only and folded, so long descriptions do not crowd the cards; its checklist still ticks there. It cannot be a list entry or a table column.

ExampleDrawn by the real interface from example data; nothing here is saved.

Mentioned in​

A read-only list of the documents whose markdown links to the shown one, each with the line around the link; a click opens that document at the line. Entries shown before “Show all” sets how many show at first. It stores nothing, so it cannot be a list entry or a table column. Every note has one at its bottom; see links between documents.

Ratings​

A rating is one numerical value, shown as dots, a number, or filled boxes. It records how much of something the document has; the chosen game's rules explain what that number means.

Click or tap the dot for the value you want: the dots before it fill too. Pressing the last filled dot again lowers the value by one; repeat to clear it, unless a minimum keeps some dots filled. With a keyboard, focus a dot with Tab and press Enter or Space. In number form, type the value or use the arrow keys; both forms keep the field's limits.

If there is a specialty text input, type its name there. The S, P, and E buttons switch specialization, practiced, and experienced on or off separately from the number. Their effects depend on the game. A left click on the die puts the rating's pool into the dice panel; a right click rolls it at once. See rolling from a sheet.

In tracker form, a click or tap fills up to a box; pressing the last filled box lowers the rating by one. Some ratings also have secondary marks from the opposite end, such as Humanity's Stains. Right click an unfilled box, use Shift+Enter or Shift+Space on it, or long press it on touch to put or clear those marks from the end. A secondary mark cannot cover a filled box; the page explains a refused mark. Raising the rating reduces secondary marks that no longer fit. These marks are a second value, rather than the editable capacity of a resource.

In the editor, Presentation chooses Dots (one dot per point), Number (a number box), or Tracker (up to 20 boxes). Templates saved with the older "boxes" presentation open as dots and keep their values.

  • Min is a floor, not a dot: the dots up to it stay filled in a darker shade, and the reader cannot go below it.
  • Max sets the number of dots. A maximum from a value or formula replaces it while it can be computed, up to 100 dots; when it drops below the stored value, the value is kept and shown in parentheses until the maximum rises again.
  • Text input (for example a specialization) adds a line between the label and the dots; on narrow screens it moves under the label.
  • Show current / maximum writes "3 / 5" after the dots; with Number it adds "/ 5" inside the number box, like a resource whose maximum cannot be edited.
  • Die symbol (roll the rating) rolls the value the way the document's game rolls an attribute of the same value; the roll names the rating.
  • Flags (dots only): S (specialization), P (practiced), and E (experienced) add the same switches as a trait row. They change the roll only where the game's dice rule uses them: the Star Wars sheet does, V5 does not.

On a brief a rating shows a few capital letters and its number instead of its full name, so many ratings fit one screen. The letters default to the first three of the label; Short label text sets your own (up to four), and Full name on the brief keeps the name where letters would mislead. In a narrow area each rating is a row (letters, number); in a wider one it is a small chip, and chips flow inside their card. The full name stays the name for screen readers and appears as a hint on hover, focus, and tap. A short label that would repeat another one in the same block takes a fourth letter (BRA and BRAC for Brawl and Brace), or a number when the names are the same (FIE, FIE2), so every rating keeps the brief look; give the ratings their real names or your own letters. On a free rating only the number shows in this form: its dots, text, flags, and die are not part of it.

Marks of another value from the end adds the secondary marks: name the Value of the marks (a number field or a game value) and the Mark name. A game's own single value, such as V5 Humanity, takes the same Display: Tracker and marks.

Formulas and display conditions read the rating's number; its text and flags do not change it. Ratings with the same shared value key share the number, the text, and the flags.

ExampleDrawn by the real interface from example data; nothing here is saved.

Document references​

A document reference is a link from one document to another, such as a group's member or a vehicle's pilot. It keeps the documents connected without copying their contents.

Type part of a document's name in the search and choose a result to add its link. On a brief, press Add first to show the search. The search offers documents of the allowed kinds in the same setting, excluding this document and entries already linked here. A field may hold one link or several; to replace a single link, remove it first.

Hover, focus, or tap a linked name to preview its card, as for a link in a note; use its open icon to open the document. The × beside an editable link removes the link and keeps the other document.

An incoming Member of list shows the groups whose Members link to this character. It is read-only here: open a group and edit Members there to add or remove membership. This uses reference fields, while Mentioned in collects incoming links written in Markdown.

Allowed document kinds lists the kinds of the page's own setting, each once: the setting's own kinds (a Hunter page offers the hunter), the ruleset's shared kinds (the V5 mortal), and the kinds you created in that setting or for the whole ruleset. A page of the rules themselves (the V5 mortal's, a Storyteller character's, a group's) offers every kind of those rules, the Hunter and Vampire ones included. Kinds of other games and of your other settings are not offered, even when they have the same name. When two offered kinds would read the same, the setting is added to the name; your own kind of the same name in the same setting is marked "(yours)". A new reference points at the page's own kind.

Show the documents that link here turns the field around: it stores nothing and lists, read-only, the documents of the allowed kinds whose own fields link to this document. Every V5 character page uses one for Member of, the groups whose members include the character.

  • A reference saved earlier may point at a document of another setting. It stays: the entry shows the document's title, notes "outside this setting", opens it, and can be removed. Once removed, that document is not offered again.
  • A document that was deleted shows "Linked document no longer exists" until the reader removes it.
  • A kind the setting no longer has (a deleted type, or one from another setting) stays checked and is marked "(unavailable)", and the template's problems list names it. Uncheck it to drop it; the last kind cannot be unchecked.
ExampleDrawn by the real interface from example data; nothing here is saved.

Tables​

A table is a list of rows with the same columns; every column is a field. Min rows and Max rows bound how many rows readers can add. Reorder the columns with their grip or their up and down arrows: filled values stay with their column.

On the sheet, readers reorder rows and entries of tables and lists: drag a row by its grip, use its up and down arrows, or press Alt+↑ / Alt+↓ in the row. The new order is saved with the document. Read-only documents show no move controls.

ExampleDrawn by the real interface from example data; nothing here is saved.

Lists​

A list of kind Entries holds entries added one by one: your own entries, or a list the game already keeps for the document (skills, merits and flaws, equipment).

A list with its own entries sets up one Entry: pick its type — text, number, toggle, choice, rating, resource, document reference, or image — and its settings, as for a field of that type. Every entry the reader adds is a copy of it. A new list starts with the classic trait row: a rating with dots, the S/P/E flags, and a die.

  • Entries are named: each entry gets a name the reader types, such as "Firearms" next to its dots. Turn it off for lists of notes or pictures: then each entry shows the entry's label, or nothing when Show label is off.
  • Preset entries start a new document with ready rows: their names, and their numbers where the entry holds one. Presets need named entries.
  • Each entry has its own remove button: at the end of the row, or above a block such as a picture or several lines of text.

Changing the entry type or turning names off can hide values readers already stored. Save then lists how many values or names each list would stop showing and asks first. The values stay stored: changing the entry back shows them again, except for entries edited in between.

ExampleDrawn by the real interface from example data; nothing here is saved.

Trackers​

A tracker is a set of levels (such as Bruised … Incapacitated) with boxes the reader marks. A click moves a box to the next fill mark, and from the last one back to empty. A new tracker starts as a seven-level health track with its penalties and two marks.

  • Source: Own values keeps the marks with the page. A game's built-in track (health, damage, willpower, members) keeps them in the document itself, so every page of that document shows the same marks; see Built-in trackers.
  • Display: Table (a row per level), Strip (a row of boxes per column), or One line (small boxes with the label inline, for brief pages; no length buttons and no legend).
  • Marks: up to five. Each has a name, a symbol of one or two characters, and a fill: amber, red, violet, green, ink, or accent (the rating dots' color) follow the light and dark themes, or pick your own color. Start from… offers one mark, two (bashing ╱, lethal ×), or three as in WoD 20th (adding aggravated ✱ in violet), or Points: current and maximum. The order is the click order, and a later mark counts as heavier.
  • Layer of a mark: a Fill colors the box behind its symbol; an Outline draws a ring in the mark's color around the box. A box holds one fill and one outline at once, so an outline can show a maximum (Force Points) or a condition (bleeding) next to the damage. A click changes the fill. The outline action puts the first outline mark on by the same rules: a right click, Shift+Enter or Shift+Space on a box, or a long press on a phone. Other outline marks come from the legend. A tracker whose marks are all outlines cycles them with a plain click. Without outline marks, the right click opens the browser's menu as usual.
  • Levels: up to twenty, each with a name and a short value, such as a penalty "-1", a bonus "+2", or a word. The value column has its own title and can be hidden. Move levels and marks with the up and down arrows: stored marks stay on their level and kind.
  • Columns: Marks (boxes) or Text (a short note per level, such as "Source"). A column covers all levels or the first few shown. With Readers add copies (A, B, C…) the reader adds copies of the column, up to the number you set, like the members of a fodder group; removing a copy that holds marks asks first. A strip shows marks columns only.
  • Readers switch the length: list the lengths and tick the levels each shows, like a fodder group's 3, 5, and 7. When the reader shortens the tracker over marked levels, it asks first; then each mark keeps its place in the shown order and the marks past the new end fold into its last level, the heaviest one winning.
  • Marks fill from the start: marking a box marks every box before it, like a rating's dots; marking the last marked box takes just that one off. Each layer runs on its own, so the outline can frame a maximum and the fill count the points inside it, and the legend's marks run the same way. Fills stay inside the outline stops a fill at the last framed box.
  • Reading the marks: the Total row shows, for each marks copy, either the value of the deepest marked level (Deepest level) or a Count of the filled boxes, with the framed ones after a slash ("2 / 5") when the tracker has outline marks, under a thicker divider. Mark a copy as out strikes a copy through once its last shown level is marked. The total and "out" read the fills; outlines never count. Name the marks under the tracker adds a legend of the marks' symbols and names; it is off by default, built-in trackers included.
  • Marking with the legend: with the legend on, the reader presses a mark in it (a yellow frame shows it is picked); each click then puts that mark on a box in one step, or takes it off when the box already has it. Pressing it again or Escape stops. Shortening folds fills and outlines each on their own.

Removing levels, marks, columns, or copies can hide marks and notes readers already stored. Save then says how many each tracker would stop showing and asks first. The values stay stored, but a removed part added again is a new part, so they do not show again.

A tracker cannot be a table column or a list entry: its copies already repeat it.

ExampleDrawn by the real interface from example data; nothing here is saved.

Built-in trackers​

A game's own track takes the same settings: the display, the names and values of its levels (a level you leave empty keeps the game's name and penalty), the names, symbols, and fills of its marks, extra columns, the total row, and the legend, which works as a brush here too. Its marks are always fills: the game keeps one mark per box. The game keeps the number and order of levels, a length computed from traits (V5 health and willpower), the number of marks, and the members of a group; lengths and "out" follow the game's rules. Columns you add keep their values with the page, next to the document's own marks.

Pages saved before this setting existed keep their look: a track on a brief reads as One line, and a stored track view keeps its display.

Buttons​

A Button does something when the reader presses it: it rolls dice and changes values, or only changes values. Add one from the + menu.

  • Label and Icon are what the reader sees.
  • Roll dice turns on the roll. Dice to roll is dice notation; a part in braces is a formula computed first, so {max(1, 10 - humanity - stains)}d10>=6 rolls one die per empty box, at least one. Rolls per press repeats the roll (a formula, so a power can pay its cost). Re-roll a failed roll once while re-rolls a failure while its formula holds. A roll succeeds at a total of sets what counts as a success: for d10>=6 the total is the number of successes. Roll with the game's dice turns dice into the game's special dice, as character rolls do (V5 Hunger dice); it is off by default.
  • On a success, On a failure, and After all rolls list the changes: a Value (its key, or .current / .max of a pool), Add or Set to, and an Amount (a formula: 1, -1, row.cost). An added value stays within its bounds; the message says when it was already at its limit. A button without a roll applies its success changes directly — a "spend a point" button.
  • Available while disables the button, with the reason, until its formula holds.
  • Text on a success and Text on a failure are added to the result message.

The roll goes to the dice panel like any sheet roll: 3D dice, history, and sharing. The message names every change, and Undo in it puts the values back for a few seconds; a value the reader changed in the meantime is kept. Cancelling the 3D roll writes nothing more. In a read-only document buttons are disabled.

Row buttons of a table or a built-in list of rows put a button on every row; its formulas read that row as row.<column> (row.level, row.cost).

A button's Documentation link, under Visibility and help, adds a separate ? beside the action. Row buttons have the same setting for their repeated action. Open the explanation with a click or focus it and press Enter; it does not roll or change values, and remains available while the action is disabled. Clearing the link removes the mark. Buttons have no automatic help destination.

ExampleDrawn by the real interface from example data; nothing here is saved.

Built-in page parts​

Shipped pages also use built-in parts: traits, resources, and lists the game itself keeps for the document. They look like the fields above and store their values in the document, so every page of that document shows the same numbers.

A pool resource (a current value and a maximum, such as Force Points or Willpower) shows as dots by default. Display: Tracker draws it as one row of boxes instead: the maximum framed, the current points filled, and the count after them ("2 / 5"). Row sits with rating rows (label on the left, boxes the size of rating dots in the accent color); Strip and One line look like the tracker displays. You can rename, re-symbol, and recolor the two marks and turn on the legend; which mark fills and which frames is fixed. A click sets the current points, the outline action sets the maximum, and both keep the game's limits: Current at least and Maximum at least take a value or a formula, and the boxes they hold are drawn darker and stay. A pool whose current value raises its maximum (Star Wars Willpower) raises it from the tracker too.