Visibility
Every file is visible to the Game Master or hidden from it. Visible is the default and the right setting for almost everything. A hidden file doesn't exist as far as the GM is concerned.
What the GM does with it
A file is either visible or hidden:
- Visible: the GM can find the file by name, list it in its folder or type, read it whole, get it back from research, and update it. It costs nothing until a turn needs it, so a library of a thousand lore files is fine.
- Hidden: the GM can't find, list, read, research or change it, and it isn't counted in the folder sizes the GM sees. A reference to a hidden file reads as its slug, and a mention as its name.
Hiding a file takes effect for finding and reading at once, even in a running game, and for research within moments.
Two more stored values, pinned and partial, are deprecated with GM
Harness V1. A file saved with either is read as visible.
Where it is set
A file's own setting wins. A file with none follows its type's default, and a type with none is visible. So hide a whole type when every file of it is for you (a Design Notes type), and hide single files otherwise.
To hide one file, click the visibility button at the end of its row in the file tree, or in the file editor's toolbar; each click flips it, and a hidden file's button stays red. To set a type's default, edit the type and set Default Context Visibility.

The same works in a game you own, on the game's own copies.
When to hide a file
Hide a file when the GM finding it would make the game worse:
- Your own notes: to-do lists, design notes, ideas not settled.
- Drafts and old versions: a rules file you replaced but haven't deleted. If two files disagree, the GM may use the wrong one.
- Duplicates: a second copy left by an import.
- Material for you, not the game: an art style guide, a changelog.
Don't hide a file because it is long or rarely used: the GM reads only what a turn needs. And keep secrets visible: the GM needs the villain's plan to run it, even when players must not learn it.
What players can see
Nothing is hidden from a game's owner, who in a solo game is the player: they can open the game's files and its GM Instructions. A secret is kept by the GM not telling it. A world's twist goes in a GM instruction; a person's secret goes in a field of their own file, off the sheet. Don't make a type only to hide something, and don't name a file after the secret.
Visibility is about the GM, not players. Players see a file through its type's sheet, but the sheet only decides what is shown: no field is hidden from players, and a game's owner can open a file's data. Keep a secret the GM needs (who really did it) in a field off the sheet, and add an always-on GM instruction not to reveal it until the players find it out.
Who sees hidden files
Visibility applies only to the GM. Orbit sees and edits every file, hidden or not, and a CLI workspace holds every file, so you can still work on your notes and drafts.
Fixed by type
Some built-in types have a default you can't change:
| File type | Visibility, always |
|---|---|
| Game Start | "searchable" |
| Script | "hidden" |
A script is run by the GM, never read, so it stays hidden, and a single script can't be shown either. A game start file can still be hidden on its own. The GM doesn't look up game starts as world files either: it gets the one a game began from when the game starts.
Values
pinned
Deprecated (GM Harness V1): Always in the Game Master's context, in full. The GM reads it as visible.
| Stored value | Label | Default |
|---|---|---|
"pinned" |
Visible (deprecated value) |
partial
Deprecated (GM Harness V1): Only title and description in the Game Master's context. The GM reads it as visible.
| Stored value | Label | Default |
|---|---|---|
"partial" |
Visible (deprecated value) |
searchable
Visible: the GM can find and read the file. The stored name, searchable, is from GM Harness V1 and is still what a visible file saves as.
| Stored value | Label | Default |
|---|---|---|
"searchable" |
Visible | yes |
Write this value to make a file visible.
hidden
Completely hidden from the Game Master.
| Stored value | Label | Default |
|---|---|---|
"hidden" |
Hidden |
The GM can't find, read, research or change the file.