Help & Guide

How to use
WanderingCodex

Every feature, and how to make the most of it. New here? Start at the top. Looking for something specific? Use the menu.

Getting started

A world is your project: a self-contained setting with its own Lexicon, stories, assets, and members. Create one from My Worlds, give it a name and a visibility (private, unlisted, or public), and you land on the world dashboard.

The world home page is a dashboard. Across the top sit word, page, member, and thread counts. Below is a recent-activity feed showing who edited what, new threads, new replies, and new members, so collaborators always know what changed. The left sidebar switches between Search, Lexicon, Stories, The Web, Cast, Boards, Sessions, Assets, Notifications, and Settings.

On My Worlds, each world appears as a card showing its visibility and total word count. The three-dot menu on a card lets you edit or delete that world.

The first time you reach My Worlds, a short welcome tour walks you through creating your first world and finding your way around, highlighting each control as it goes. You can leave it at any time, and replay it whenever you like from your avatar menu → SettingsReplay welcome tour.

Accounts & sign-in

Sign up and sign in with an email and password, or with your Google account. If you use Google with the same email as an existing account, the two are linked automatically. Sign-in and registration are protected by a human-verification check to keep out bots. New members receive a welcome email.

Lexicon & pages

The Lexicon is a tree of pages you can nest under folders. Create pages, folders, and maps from the + New control in the Lexicon sidebar. Each page has an icon you can change, an optional banner image across the top, and can be split into multiple tabs (for example a public description and private GM notes). Clicking Lexicon in the sidebar always opens the first page in the tree directly.

To set or change a page's cover image, hover over an existing banner and click Change cover, or click the + Cover image button that appears above the title when no banner is set. The picker lets you upload a new image or choose one already in your world's asset gallery. You can remove the cover from the same picker at any time.

When you open a fresh, empty page, a template picker offers starter layouts for common page types. Pick one to get a head start, or dismiss it to write on a blank page.

Link pages together by typing @ while editing and choosing a page. Click a Lexicon link to jump to the page it references (Ctrl or Cmd click opens it in a new tab), and hover over one to see a quick preview of that page. Linked pages also appear in the Mentioned in backlinks panel on the target page, so your world stays interconnected automatically.

Auto-link does the linking for you. The Auto-link button in a page header scans your prose for any text that matches another page's title (whole words only, not case sensitive) and proposes a link to that page. It works on regular pages and on manuscripts, where it scans every chapter, so a manuscript can link back to the lexicon pages it mentions. Choose whether to scan just the current page or the entire lexicon, and whether to link only the first mention on each page or every mention. You then see the full list of suggested links, each grouped by page (and chapter) with a snippet of surrounding text, and you can uncheck any you do not want before applying. Text that is already linked, page titles inside headings, and a page linking to itself are all left alone.

Folders can hold an intro of their own: open a folder page and write a blurb at the top to describe what it contains. The list of pages inside the folder appears below it under Contents.

Any page or folder can be marked GM-only using the padlock button in the Lexicon toolbar. Hidden pages disappear from the sidebar and are blocked at the server for players and guests. Hiding a folder hides the entire subtree inside it. See GM secrets & visibility for the full system.

The editor & slash commands

Pages use a rich editor that saves automatically as you type. The fastest way to add structure is the slash menu. Type / on a new line and a menu of blocks appears. Keep typing to filter, use the arrow keys to move, and press Enter to insert.

Type / and you'll see:
H1
Heading 1 / 2 / 3
Section headings in three sizes.
Bullet list
An unordered list.
1.
Numbered list
An ordered list.
To-do
A checkbox checklist.

Every block you can insert

H1
Heading 1 / 2 / 3
Section headings in three sizes.
Bullet list
An unordered list.
1.
Numbered list
An ordered list.
To-do
A checkbox checklist.
"
Quote
A blockquote for cited text.
💡
Callout: Info
A blue highlight box for notes.
⚠️
Callout: Warning
A yellow box for cautions.
🔴
Callout: Danger
A red box for critical info.
Callout: Success
A green box for positive notes.
Collapsible
An expandable section with a clickable summary.
2 Columns
A side-by-side two-column layout.
🔒
Secret
A GM-only block for hidden notes.
Divider
A horizontal rule between sections.
Table
A 3x3 table with a header row.

The toolbar also offers bold, italic, and text color, and its callout button lets you pick the callout style (info, warning, danger, success, or tip). The Secret block is built for GMs: keep hidden plot notes on the same page as public lore. Callouts, collapsibles, and columns can be nested to build rich, scannable pages.

Tags, properties & comments

  • Tags. Add short labels below a page title (editors only). Tags autocomplete from ones already used in the world, so your vocabulary stays consistent. Use them to group characters, factions, or regions.
  • Properties. A side panel of custom name and value fields, like an info box. Add things like Race, Population, or Status for quick reference without burying them in prose.
  • Comments. Leave notes on a page for your collaborators. Anyone with access can comment; editors can resolve and unresolve them. Useful for feedback and to-dos without touching the page text.

On a phone these panels collapse into tappable headers so the page body stays the focus; tap a header to expand the panel you want.

Revisions & word goals

Every page keeps a revision history. Snapshots are taken automatically as you edit, at most one every few minutes so the list stays clean. Open History on a page to see who changed it and when, and restore any earlier version with one click. Restoring is itself saved, so you can never lose work.

Each page tracks its word count. Click the word count to set a word goal; a progress bar fills as you write, and reaching a goal of 100 or more words earns XP. World cards in My Worlds show the combined word count of all their pages.

Maps

Create a map page and set an image as its background, then drop pins on it. Each pin can carry a label, a description, a type, a color, and a link to a Lexicon page. Outside edit mode, clicking a pin takes you straight to that location's lore; pins can also point to other maps, letting you nest a continent down to a city.

Press Edit pins to make changes. In edit mode, click the map to add a pin and drag any pin to reposition it. Each pin sits inside a colored ring you can recolor in the pin dialog (pick a preset, the world accent, or a custom color) so different kinds of places stand out. Use the zoom controls (or Ctrl and the scroll wheel) to move between an overview and fine detail.

GM secrets & visibility

WanderingCodex has a layered visibility system that lets GMs keep hidden notes, plot hooks, and NPC secrets on the same pages as player-facing lore, without ever leaking them. Hidden content is stripped on the server before it reaches a player's browser.

  • Secret pages. The padlock button in the Lexicon page toolbar marks a whole page as GM-only. The lock icon appears next to hidden pages in the sidebar so editors always know what is concealed. Hiding a folder hides the entire subtree inside it. Players who try to open a hidden page by direct URL receive a 404.
  • Secret blocks. Inside the editor, the Secret block (type /secret) hides a section of inline content on an otherwise public page. Write GM notes alongside player lore on the same document; only editors and GM-tier viewers see the block.
  • Secret properties. Individual custom properties on a Lexicon page can each be flagged as GM-only using the padlock icon next to the property. The lock badge marks them for editors; players see the rest of the properties without the hidden ones.
  • Secret map pins. Any pin on a map can be toggled GM-only from the pin edit dialog. Secret pins vanish from the map for players and from the relationship graph, while remaining fully visible and editable for the GM.

Controlling who sees secrets

Two controls in world Settings determine which members see GM-only content:

  • Minimum role threshold. The Minimum role to see secrets setting (default: Moderator) grants every member at or above that role full GM visibility. Raise it to Admin if you only want owners and admins to see hidden content, or lower it to Player for lighter games where players have more access.
  • Individual allowlist. You can also add specific members to the secrets allowlist from the Secrets section in Settings, granting them GM visibility regardless of their role. Useful for trusted co-GMs who hold a Player role.

View as player

Editors can preview the world exactly as a player would see it by clicking the View as player eye button in the top toolbar. An amber banner confirms you are in preview; all secrets are stripped, editing is disabled, and the document tree shows only public pages. Click the banner to return to editor mode. This works on any page, including maps, so you can verify pin visibility without switching accounts.

The Web

The Web (the relationship map) maps how the pages in your world connect. Every node is a Lexicon page (a character, faction, location, or anything else), and every line is a connection you define between two pages. It is an interactive, force-directed canvas: drag nodes to arrange them, scroll to zoom, drag the background to pan, and use Fit to center the view. Click a node to highlight just its connections; click a line to open its detail panel.

Each connection has a type, shown by color, so the shape of your world reads at a glance:

Ally / FriendRival / EnemyFamilyRomanceAffiliationLocationRelated
  • Direction and labels. A link can be directed (A to B, good for "rules over" or "member of") or mutual (A and B, good for friends or rivals). Add a short label like "mentor of" to name the bond.
  • Rich details. Every connection has a Details note that uses the full editor. Write as much as you like and type @ to link Lexicon pages inside the description. It autosaves as you write.
  • Linked page. Tie a connection to a dedicated lore page (for example a "Battle of the Iron Pass" page) so readers can jump to the full story behind it.
  • Relationship history. Every time a connection is created or changed, a snapshot is recorded. Click any connection line to open its panel, then scroll down to the History section to see a timestamped log of every edit and who made it. The node panel also shows when each connection was last updated.
  • Layout lock. Moderators and above can click Lock in the toolbar to save every node's current position. Locked layouts persist across page reloads; the status bar shows when the lock is active. Clicking, zooming, and panning all keep working while locked; only the node positions are fixed. Click Unlock to resume physics. Use Re-layout (only visible when unlocked) to reset to a fresh automatic arrangement.
  • Entity-type icons. Node bubbles now reflect what kind of page they represent. Pages with person-like icons (characters, warriors, wizards, and similar) show a head and shoulders silhouette. Pages with location-like icons (castles, dungeons, towns, and similar) show a building with a roofline. Other pages show the page title's initials.
  • GM secret filtering. Pages marked GM-only do not appear in the graph for players or guests. Any connection whose source or target is a hidden page is also hidden.
  • Connections panel. You do not need The Web to manage links. Every Lexicon page has a Connections panel where you can view, add, edit, and remove that page's connections inline.

The legend at the bottom left doubles as a filter: click a type to hide or show it. Editing connections is limited to moderators and above; everyone with access to The Web section can view it.

Cast & character roster

The Cast tab is a world's character roster: a shared list of the characters taking part, who plays each one, and a link straight to their bio. Characters come from your personas, so the same character can appear across every world you join.

  • Adding a character. Any player or above can click + Add your character on the Cast tab and pick one of their own personas. A persona appears in a world at most once.
  • Browsing bios. Click any cast member to open their bio inside the world. The page shows their character art and notes; the player who owns the character sees an Edit bio link that opens their character sheet, so you always keep ultimate control of your own bio.
  • Removing a character. You can remove your own character from a world whenever you like. Moderators and admins can also remove any character from a world they run, for example when a player leaves the game.
  • Visibility. Like every section, admins can set the minimum role required to see the Cast tab from world Settings.

Asset gallery

Every world has an Assets tab: a gallery of images and files you upload once and reuse anywhere. Uploaded images can become page banners, map backgrounds, and character art. Keeping your artwork and reference files in one place means you are never re-uploading the same image twice.

Stories & play-by-post

Stories are threaded discussions and collaborative fiction, organized into Chapters (the Boards section organizes its threads into Categories the same way). Threads come in four types: discussion, in-character (play-by-post), out-of-character, and announcement. Posts use the same rich formatting as the Lexicon and can @-link Lexicon pages. Threads can be pinned to the top of a chapter, and locked to stop new replies.

  • Reading a thread. Threads read as a "Chronicle Spine": posts hang off a single glowing timeline, in-character posts show the character's name and avatar with their prose set in a large serif (and an illuminated drop-cap on the opening post), while out-of-character notes appear as quieter cards. The chapter and thread index lead with the most active entry as a featured card.
  • Watching. Click Watch on a thread to get notified of new replies, even if you have not posted in it. Replying subscribes you automatically. Click again to stop watching.
  • Quoting. Use Quote on any post to cite it in your reply. The quote appears as a block that links back to the original, so conversations stay easy to follow even in long threads.
  • Lore links. Lexicon pages that get @-mentioned in a story show those threads in their Appears in panel, tying your fiction back to your lore.

Personas & character sheets

A persona is a character you speak as in Stories, separate from your account. Create and manage personas from your account menu. Each persona has a name and an avatar.

When you write a reply, a Post as selector lets you choose yourself or any of your personas. Posting in character shows the character's name and avatar on the post, with a quiet note that it is played by you.

Each persona has a character sheet: upload character art and write a full bio using the same rich editor as Lexicon pages. In a thread, tap a character's name to open their sheet as an overlay without leaving the conversation.

XP, levels & streaks

Creating and writing earns XP, shown as a level and progress bar in the nav bar and account menu. It is a gentle nudge to keep building, not a competition.

Writing
+10 XP for every 100 words added to a page
Daily streak
+5 XP per consecutive day you save, up to +35/day at a 7-day streak
New Lexicon entry
+25 XP for creating a page or map
Word goal met
+100 XP the first time a page reaches a goal of 100+ words
Story reply
+5 XP for each post you make in a thread
Inviting a member
+15 XP when a new collaborator joins your world

Writing streaks reward consistency. Save something on consecutive days and your streak grows, with a bonus that climbs to its cap at a week. Streak days roll over at your local midnight (your browser's timezone is detected automatically). A 🔥 streak count appears in your account menu once you are on a roll.

You progress through a series of titles, and each title has ten tiers (Wanderer 1 through Wanderer 10, then on to Scribe, and so on). Each tier costs more XP than the last, so later titles are a longer journey. After Legend 10 the rank becomes Eternal and keeps climbing without limit.

Wanderer 1–10Scribe 1–10Chronicler 1–10Lorekeeper 1–10Archivist 1–10Sage 1–10Elder Sage 1–10Mythweaver 1–10Worldshaper 1–10Legend 1–10 Eternal

Open the Level & progress tab in your account settings for a full breakdown: your current title and tier, how much XP each activity has earned you, your writing streaks, and the title ladder.

Notifications

The bell in the nav bar shows an unread count and a dropdown of recent activity. It checks for new items periodically, so you do not need to refresh. Each notification links to whatever triggered it, and you can mark a single one or all of them as read.

You get an in-app notification when:

  • A new thread is posted in Stories or Boards (subject to your section preferences).
  • Someone replies to a story or board thread you started, posted in, or are watching.
  • A comment is added to a Lexicon page in your world (subject to your Lexicon section preference).
  • A GM manually sends a session notification to share a session log with the group.
  • You are invited to join a world.

Controlling what you receive. The Notifications tab in Account Settings lets you set account-wide defaults for each section: Stories, Boards, Lexicon, and Sessions. Each world also has a Notifications page in the sidebar (the bell icon) where you can override those defaults just for that world, setting any section to Default, On, or Off.

Email notifications respect the same per-section and per-world controls. Account and invitation emails are always sent. Reply emails require the "Email me when someone replies to a thread I follow" toggle to be on in Account Settings. All other notification emails follow your section preferences.

Your account menu

Your avatar at the top right opens a small dropdown showing your level, XP bar, and writing streak. Clicking your name or the settings link opens the full Account Settings overlay, which has four tabs:

  • Profile & characters. Upload a profile photo, manage your personas (add, delete, and upload portrait art for each), and jump straight to any persona's character sheet.
  • Account & security. Change your password or update your primary email address; both require your current password to confirm. When you request an email change, a verification link is sent to the new address and the update only applies once you click it. These options are not available for Google OAuth accounts. Archivist members can also claim a custom world URL (a vanity handle) here; once set, all your worlds are reachable at /yourhandle/worldname in addition to the default URL. Handles are globally unique, claimed once per account, and free to use by others again after a 30-day period if your plan lapses.
  • Notifications. Set your account-wide defaults for which sections (Stories, Boards, Lexicon, Sessions) generate in-app and email notifications. Also toggle product news emails and reply emails here. You can override these defaults on a per-world basis from the world's Notifications sidebar page.
  • Support. Send a question or bug report to the WanderingCodex team without leaving the app.

Roles & permissions

Every world uses a tiered role system. Each role inherits everything the role below it can do and adds more. This lets you run anything from an open public Lexicon to a tightly gated campaign where players see only what you choose.

Guest
Anyone who has not joined the world. Sees only the sections an owner has opened to the public.
Visitor
An invited member with read access. Can browse the sections allowed to them but cannot post or edit.
Player
Everything a Visitor can do, plus posting in Stories and Boards threads.
Moderator
Everything a Player can do, plus editing Lexicon pages and managing content.
Admin
Everything a Moderator can do, plus world Settings: inviting members, changing roles, and section visibility.
Owner
The creator of the world. Full control, including deleting the world. Only the owner can promote someone to Admin.

Section visibility

Owners and admins control who can see each part of a world. In world Settings, the Section visibility panel sets a minimum role for every section: Lexicon, Stories, Boards, Sessions, The Web, Cast, Assets, and Search. Set a section to Guest to make it public, or raise it as high as Admin to hide it from everyone but your staff. You could, for example, expose the Lexicon to the public while keeping Stories and Boards limited to Players and above. Sections a member cannot reach simply do not appear in their sidebar.

GM secret threshold

The Minimum role to see secrets setting in world Settings controls which roles can view GM-only pages, properties, and map pins. The default is Moderator: any member at Moderator or above sees all hidden content. Raise it to Admin for tighter control, or lower it to Player for lighter games. Members added to the individual secrets allowlist always see GM content, regardless of their role. See GM secrets & visibility for details.

Sharing & collaboration

Each world has a visibility: private (only members can open it), unlisted (anyone with the link), or public. Set it in world Settings. Section visibility (above) then refines what each role sees inside the world.

Invite collaborators by username or email from Settings and pick their role: Visitor, Player, Moderator, or Admin. Invitees get an in-app notification and an email. Admins can change roles or remove members at any time; promoting someone to Admin is reserved for the owner. The dashboard activity feed keeps everyone oriented on recent changes.

Join requests. On a public or unlisted world, guests can ask to join with an optional message. Owners and admins review pending requests in Settings and either approve them, choosing a starting role, or deny them. You can turn join requests off for a world from its Settings.

Export & public reader

  • Per-page Markdown export. Every Lexicon page has a .md download button in the header, next to the History button. Clicking it downloads that page (and all its tabs) as a .md file. Lexicon links are preserved as [[Page Title]] references; all headings, lists, tables, callouts, and code blocks convert cleanly.
  • Full world export. Go to world Settings and scroll to the Export section. Click Download as Markdown to get every document in the world combined into one .md file, separated by horizontal rules. Useful for backups or migrating to another tool.
  • Public reader view. Worlds set to public or unlisted can be shared as a clean read-only Lexicon at /read/[world-id]. Visitors need no account. The reader shows a collapsible document tree on the left, a minimal top bar with the world name, and your content in full. GM Secret blocks are hidden from the reader. Find the shareable link in world Settings under Public Reader.
  • PDF. Inside the reader, each page has a Print / PDF button. This opens your browser's print dialog with the sidebar and header hidden, so the output contains only the document content.

Ready to build? Jump back into your worlds.

My Worlds