Welcome to WorldKonstruct
You know this feeling. You're 40,000 words into your novel when a character reappears, and you can't remember if her eyes are green or grey. You scroll back through chapters, search your notes app, check a spreadsheet you started in March, flip through a notebook you abandoned in May. Twenty minutes later you've found the answer, but you've lost the scene you were writing.
Or maybe you haven't started writing yet. You have a world in your head, vivid and alive, but every time you sit down to capture it, you end up building more world instead of writing story. The magic system needs rules. The faction politics need mapping. The timeline needs fixing. Three months later you have a gorgeous wiki and zero manuscript pages.
WorldKonstruct exists to solve both of these problems.
It's a Story Bible that lives inside Google Docs, right next to your manuscript, where you actually write. Every character, place, object, faction, worldbuilding rule and plot event is one tap away. Type @Maya in any entry and it links automatically. Rename a character and every mention updates. Scan your manuscript and WorldKonstruct finds the characters and places you forgot to track.
priority_high What WorldKonstruct Will Not Do
WorldKonstruct is not a worldbuilding playground. It is not designed to let you spend months perfecting your world instead of writing your story. Everything in it is built to get your Bible done fast so you can get back to writing. If you find yourself spending more time in the sidebar than in your manuscript, you're using it wrong. Build the Bible, look things up in the Bible, write the book.
auto_awesome Why Story Bibles Matter
Many of the best-loved fantasy worlds rest on years of behind-the-scenes work. Tolkien built the histories and languages of Middle-earth long before most of it reached the page. George R.R. Martin's detailed house histories make the politics of A Song of Ice and Fire feel lived-in. Many authors keep notebooks of rules, family trees and timelines that readers never see.
Your Story Bible isn't just organization. It's the invisible structure that makes your world feel real.
Your entire world, one tap away while you write.
Who Is WorldKonstruct For?
- Novelists — solo authors managing complex worlds across drafts
- Series authors — keeping several books consistent with one shared Bible
- Screenwriters & game designers — shared-universe builders who need linked lore
- Worldbuilders & hobbyists — anyone who loves building fictional worlds
- Co-authors — teams sharing one source of truth through a Google Sheet
lightbulb Two Ways to Work
Writer mode: Use the sidebar as your reference while you write. See your characters, places and events in a panel right next to your words. Tap any entry to pull up its details without leaving your draft.
Architect mode: Open your Bible in Google Sheets for big-picture work, such as adding a dozen characters at once, searching and replacing across your world's history, or reviewing every faction as a sortable table. Changes you make in one place show up in the other. See Keeping Sheets & the sidebar up to date.
Getting Started
Installation
Open Any Google Document
Go to docs.google.com and open the document you want to attach a Story Bible to. It can be your manuscript or a blank document.
Install the Add-on
Go to Extensions → Add-ons → Get add-ons. Search for "WorldKonstruct" and tap Install. Google will ask you to allow a few permissions. Tick all of them.
Open WorldKonstruct
Go to Extensions → WorldKonstruct → WorldKonstruct — World Builder & Story Bible. The sidebar opens on the right of your document, and you'll see the setup screen.
lightbulb Why does it ask for permissions?
WorldKonstruct asks Google for permission to read the document you have open (so it can scan it), to create and open the Google Sheet that holds your Bible, to connect to the AI, and to see your email address (so it can check your licence). Your Bible lives in your own Google Drive. See Your Data & AI and the Privacy Policy for the details.
Did you untick a permission? Google lets you do that. If WorldKonstruct says it is missing some Google permissions, tap Authorize WorldKonstruct, tick every box, then come back and tap Continue.
Choose Your Path
The setup screen asks where you are in your writing. There is no wrong choice. You can always add entries by hand, scan your document later, or link a different Bible.
auto_awesome Architects vs. Gardeners: Which Path Is Yours?
George R.R. Martin describes writers as architects, who plan everything in advance, and gardeners, who discover the story as they write. WorldKonstruct works for both:
- Architects → I want to build it myself. Build the Bible first, then write.
- Gardeners → I have pages already written. Write first, scan, and let the Bible grow.
- Series veterans → Connect it. Link a Bible you've already built.
document_scanner I have pages already written
For writers with a draft or manuscript.
Creates your Bible and scans your document to find the characters, places and more that you've already written. Full walkthrough →
add_circle I want to build it myself
For architects who want full control.
Creates an empty Bible. You add every entry yourself, at your own pace. Details →
link Already have a story wiki? Connect it
For series authors and co-authors.
Links this document to a Bible you already have. Several documents can share one Bible. Details →
5-Minute Quick Start
Let's build a small Story Bible from scratch using The Hunger Games as an example. After these six steps you'll understand how everything fits together.
Create Your First Character
Tap the + at the bottom of the sidebar. In Create New Entry, choose Character, type "Katniss Everdeen" and tap Create.
Add Details
Tap Katniss in the list. In her entry, double-click any field card to open Quick Edit. Add a few lines about who she is and what she wants. Your changes save on their own.
Create a Connected Entry
Tap + again, choose Place and create "District 12".
Link with @Mentions
Open Katniss and double-click Core Identity. Type "A hunter from @District 12 who volunteers as tribute." When you type @, a list of matching entries appears. Pick District 12.
See the Mentioned In list
Open District 12 and tap its Links tab. Under Mentioned In you'll see "Katniss Everdeen". You never created that link yourself. WorldKonstruct added it because Katniss mentions the place.
Let AI fill the gaps
Create "Peeta Mellark", open his entry and tap AI Enhance. It fills in his empty fields using what your document says about him. Anything you've already written is left alone.
check_circle You Did It!
You now know the core loop: create entries → add details → link with @mentions → see who mentions whom. Everything else in this guide builds on that.
Katniss Everdeen
The Three Pathways
document_scannerI have pages already written
Who: Writers with a draft or manuscript.
Why: You've been writing but haven't tracked your world in one place.
When: You'd like WorldKonstruct to find what's already on the page so you don't have to type it all in.
How It Works
Name Your World
Type a world name if you like, such as "The Iron Coast Saga". It becomes the title of your Bible's Google Sheet. You can leave it blank.
Scan Your Document
Tap Scan My Document. WorldKonstruct reads your document and looks for characters, places, objects, factions, worldbuilding and events. The screen tells you what to expect: short documents usually show results in 15–20 seconds, and full novels can take 10–20+ minutes. You can cancel at any time.
Review What It Found
A review screen lists everything it found. Nothing is added until you say so. Untick anything that isn't really part of your world, such as a real city mentioned in passing. See The review screen.
Add Them to Your Bible
Tap Add N to Bible. Each ticked find becomes an entry, with the surrounding text from your document as a starting point.
lightbulb Long documents
For a long manuscript, WorldKonstruct reads it in sections and avoids adding the same character twice, even when a name is spelled slightly differently or has a title in front of it ("Mr. Darcy" and "Fitzwilliam Darcy"). If it spots that a character goes by more than one name, it lists the extra names as Aliases.
auto_awesome Aliases in Action
In Arthur Conan Doyle's stories, Irene Adler is also called "the woman." If your protagonist is "Elena" in the narration and "Lena" in dialogue, WorldKonstruct can recognize they're the same person and make one entry with both names listed as Aliases.
info Every scan is a fresh look
Found something that isn't quite right? You can edit or delete any entry afterwards. Scanning again later never changes what you've already written. See Scanning again.
add_circleI want to build it myself
Who: Architects who want full control, and writers starting fresh.
Why: You want to build each entry yourself, at your own pace.
When: You prefer deliberate, structured worldbuilding.
Type a world name if you want one and tap Create Empty Bible. WorldKonstruct creates a Google Sheet with a tab for each type of entry. If you leave the name blank, it uses your document's title. From there you can add entries by hand, scan your document later, or connect the same Bible to another document.
linkConnect an existing Bible
Who: Series authors, co-authors, and anyone who already has a Bible.
Why: You want to share one Bible across several Google Docs.
When: Starting a sequel, writing another character's point of view, or co-writing.
On the setup screen, tap Connect it (under "Already have a story wiki from another document?"). Tap Browse Google Drive, choose your Bible from the picker, then tap Link Bible. You never have to hunt for links or IDs. Your entries load right away. See Series Support for how to share a Bible across documents.
Scanning & Sources
Your first scan builds the Bible. Later scans keep it up to date as you write. This section covers scanning again, what you see on the review screen, and how to use one Bible for more than one manuscript.
Scanning again
Wrote more since your last scan? Tap Scan Doc at the bottom of the sidebar. WorldKonstruct asks you to confirm first. The Scan Document? box tells you the cost (a scan uses 2 AI credits) and how many credits you have left.
WorldKonstruct remembers your last scan and only looks at what has changed. There are three outcomes:
- Nothing has changed. You'll see "Your bible is up to date — no document changes detected." Nothing is used or added.
- Some parts have changed. WorldKonstruct scans just those parts and shows you what's new.
- The document looks very different. You'll be asked to confirm with Document changed substantially. Tap Continue Scan to go ahead. It adds new finds and keeps every entry you already have.
Scanning again never changes what you've already written. If a character you already have turns up again, WorldKonstruct only makes a note of which manuscript it appeared in.
lightbulb Interrupted?
If a scan is interrupted (you closed the sidebar or lost your connection), a banner says Interrupted scan ready to continue. Tap Resume Scan to carry on, Start Fresh to begin again, or Discard to forget it.
The review screen
When a scan finishes you'll see Review scan, with a line like "Review N items in W words". Nothing is added to your Bible until you choose.
| Section | What it means | Starts as |
|---|---|---|
| Recommended | The strongest finds, ranked so the most important come first. | Ticked |
| More suggestions | Possible finds that are less central. Have a look and tick any you want. | Not selected |
| Needs review | Finds WorldKonstruct is less sure about. | Not selected |
| Already in your bible | Entries you already have. For these, WorldKonstruct only notes which manuscript they appear in. | — |
| Possible matches | Something that might be an entry you already have under another name. Nothing happens to it unless you tap Use existing. Tap Ignore to leave it alone. | Not applied |
Tap Select recommended to tick just the recommended finds again. Tick Remember items I explicitly skip if you don't want to see the same finds next time. When you're ready, tap Add N to Bible. If the review only contains entries you already have, the button reads Finish Review. When it's done you'll see All caught up!, and Scan Again is there if you want another go.
lightbulb Scanning finds nothing new?
- Your document may be very short. A few hundred words gives WorldKonstruct little to go on.
- Everything in it may already be in your Bible.
- You may have ticked Remember items I explicitly skip earlier. Untick it and scan again.
Manuscripts & Sources
Using one Bible for more than one book? Open the other book's document and tap Scan Doc. WorldKonstruct asks you to Add another manuscript. Give it a name you'll recognize, such as Book 2. WorldKonstruct won't guess it for you.
Every manuscript you scan is called a source. To see them, or to rename one, open Settings → Sources ("Manuscripts that contribute to this Bible"). You'll see "Source renamed." when it's saved.
What you'll see on an entry
- Source labels ("Scanned from this manuscript") show which manuscripts an entry came from. A character in three books shows all three.
- Manuscript notes is a collapsible panel that shows what the scan noticed in your text. It's a record of what the scan saw, so it's non-canonical: it never replaces your own fields.
- When your Bible has more than one source, the Events list is grouped by manuscript, and an event that appears in several shows "Also in…".
Working With Entries
Main View
This is the screen you'll see each time you open WorldKonstruct:
| Element | Where | What It Does |
|---|---|---|
| Header bar | Top | The sync icon (cloud_done when everything is saved), the settings gear, and an entry counter (for example 0/150 on the free plan; hover it to see "Entries used"). |
| Search bar | Below the header | Type to search all your entries. The find_in_page Find selected text button searches your Bible for the text you've selected in your document, or the word your cursor is in. |
| Category buttons | Below search | One button per type: Characters, Places, Objects, Factions, Worldbuilding, Events. Tap one to see just that type. |
| Entry list | Middle | Your entries for the chosen type. Each shows its picture, name, status and tags. Events also show a timeline number such as #3. |
| Footer | Bottom | Scan Doc scans your document for new finds. The download download button downloads your Bible as an interactive web page. + creates a new entry. Enrich All asks AI to fill in empty fields across your Bible. |
lightbulb Find Selected Text
Select a name in your Google Doc, or just put your cursor inside a word, then tap the find_in_page button in the search bar. It's the fastest way to jump from your manuscript to the right entry, with no typing.
Entry Detail View
Tap any entry in the list to open it.
What you'll see
- Back takes you to the list.
- Relationship graph shows a map of what this entry is connected to. See Relationship graph.
- AI Enhance (auto_awesome) fills in the empty fields. Delete Entry (delete) removes the entry.
- Insert summary into document puts a summary card for this entry into your Google Doc, at your cursor.
- The type label at the top (for example "Character"). Tap it to change the type. See Changing an entry's type.
- The picture: tap to see it larger, double-click to change it.
- The name: double-click to edit.
- Status and Tags: tap to edit.
- Tabs that depend on the type (a Character has Info, Details, Links and Assets).
- Field cards: each field is a card. Tap to open it, double-click to edit.
Jumping between entries
A name you've linked with @ appears as blue text. Tap it to go straight to that entry. On the Links tab, Mentioned In lists every entry that mentions this one.
Changing an entry's type
Made a place that's really a faction? Tap the type label at the top of the entry and choose the right type. The change saves in the background like any other edit. Details that the new type has no field for aren't thrown away. They're kept in a collapsed Previous details section on the entry, where you can read them but not edit them.
Creating Entries
There are four ways to add entries:
The + button
Tap + at the bottom of the sidebar. Create New Entry opens: "Add the essentials now, then continue in Quick Edit." Choose a Type (Character, Place, Object, Faction, Worldbuilding or Event), type a Name, add a picture if you like, and tap Create. If you had a short piece of text selected in your document, the name is filled in for you.
From inside an @mention
When you type @ and the entry doesn't exist yet, the list offers something like + Create new character "Name". Tap it to create a basic entry without leaving what you're writing. The link is added for you.
By scanning
Let WorldKonstruct find entries in your manuscript. See I have pages already written.
In Google Sheets
Open your Bible in Google Sheets (Settings → Open in Google Sheets) and add rows directly. This is the fastest way to add many entries at once. See Sheets-First Workflow.
info Adding lots of entries?
If you create four or more entries within a few minutes, a banner suggests switching to Google Sheets. It really is quicker for bulk work, so it's a recommendation, not an error.
Editing Entries
Quick Edit
Double-click any field card to open Quick Edit, a full-screen editor for that field. It has:
- The field name and entry name at the top
- A text box for editing. Simple formatting works:
**bold**,*italic*,- listsand headings (type##, a space, then the heading, like## Chapter Notes) - Automatic saving. Your changes save as you type.
- Open in Sheets, which jumps to this exact cell in your Google Sheet
warning There is no Undo in Quick Edit
Quick Edit saves as you type. If you delete something by accident, tap Open in Sheets, then use Google Sheets' File → Version history to get the earlier text back.
Fields
- Formatting shows up when a field is closed.
- Names you've linked with
@are tappable links. - Open a field and use the content_copy button to copy its text without the link markup, ready to paste anywhere.
- Empty fields say "Not set. Click edit to add."
lightbulb Status and Tags
Every entry has one Status: blank, Stub, Draft, Complete, Deceased or Missing. Use it to see at a glance how finished an entry is, or whether a character is still alive. Tags are free-text labels you can use for themes, chapters or anything else. Tap either one (no double-click needed) to change it.
Entry Types
WorldKonstruct organizes your world into six types. Each has its own fields and its own tabs. (In your Google Sheet, the Places tab is called Locations.)
Character
| Field | Purpose | Example |
|---|---|---|
| Name | Full name | Jon Snow |
| Aliases | Other names | The Bastard, Lord Snow, The White Wolf |
| Core Identity | Who they are | Bastard son of Ned Stark, raised at @Winterfell |
| Appearance | What they look like | Dark hair, grey eyes, lean build |
| Backstory | History before the story | Raised alongside the trueborn Stark children… |
| Voice & Personality | How they speak and come across | Formal, earnest, avoids humor |
| Core Motivation | What drives them | Prove his worth despite his birth |
| Core Fear | What they avoid | Being truly alone, without family or purpose |
| Status | How finished the entry is, or whether they are alive | Draft, Complete, Deceased, Missing |
| Tags | Your own labels | Stark, Night's Watch |
Tabs: Info | Details | Links (relationships and Mentioned In) | Assets (picture, images, links)
lightbulb Cast order
After a scan or Enrich All, WorldKonstruct may tag your main characters with their story role (protagonist, antagonist and so on) and list them at the top of the Characters tab, with everyone else in alphabetical order. You'll see the role in each character's Tags.
auto_awesome From the Masters: Jon Snow
Martin's Jon Snow works because every part of him supports the others. His outsider status creates his need to prove himself. His backstory as the bastard of Winterfell creates his fear of being alone. Even his formal, earnest voice reflects someone who is always performing legitimacy. When you build a character, ask: does each field support or complicate the others?
Place
| Field | Purpose | Example |
|---|---|---|
| Name | Name of the place | Hogwarts School of Witchcraft and Wizardry |
| Description | What it looks and feels like | A sprawling medieval castle in the Scottish Highlands… |
| History | How it came to be | Founded by four wizards over a thousand years ago… |
| Aliases | Other names | The Castle, School |
| Status | How finished the entry is | Draft |
| Tags | Your own labels | magical, school, Scotland |
Tabs: Info | History | Links | Assets
check_circle The Five Senses Test
A place description should answer: what do you see? Hear? Smell? Feel, in texture and temperature? Taste, if it matters? Hogwarts isn't just a castle. It smells of old parchment, echoes with moving staircases, and feels cold in the dungeons and warm by the Gryffindor fire.
Object
| Field | Purpose | Example |
|---|---|---|
| Name | Name of the object | The One Ring |
| Description | What it is | A plain gold band that grants invisibility… |
| Abilities | What it does | Turns the wearer invisible, extends lifespan, corrupts the bearer |
| History | Where it came from and where it has been | Forged by @Sauron in Mount Doom… |
| Current Holder | Who has it now | @Frodo Baggins |
| Aliases / Status / Tags | The usual extras | The Precious, Isildur's Bane |
Tabs: Info | Details | Links | Assets
lightbulb Chekhov's Gun
If an object appears in your story, it should matter. The One Ring isn't just jewelry. It drives the whole plot. When you create an object, ask: what trouble does it cause? Who wants it? What happens if it's lost or destroyed?
Faction
| Field | Purpose | Example |
|---|---|---|
| Name | Name of the group | House Stark |
| Goals | What they want | Keep the North safe and honor their oaths |
| History | Where they came from | Descended from the First Men, thousands of years of rule… |
| Key Members | Characters who belong to the group | @Ned Stark (Lord), @Arya Stark (daughter) |
| Aliases / Status / Tags | The usual extras | The Wolves |
Tabs: Info | Members (linked characters and their roles) | Links | Assets
lightbulb Key Members
When you use AI Enhance or Enrich All on a faction, WorldKonstruct works out which characters actually belong to the group, not just who is mentioned in its text. It won't list an investigator or an enemy as a member.
auto_awesome From the Masters: House Stark
Martin's factions work because each has a clear identity (wolves, honor), internal tension (duty against survival) and relationships with other factions (Stark against Lannister). Use Key Members to show the power dynamics inside the group.
Worldbuilding
A flexible type for rules, systems and lore that don't fit anywhere else.
| Field | Purpose | Example |
|---|---|---|
| Title | Name of the system or idea | Allomancy |
| Content | The full description | A magic system powered by swallowing and "burning" metals… |
| Aliases / Status / Tags | The usual extras | Metal Arts |
Tabs: Info | Assets
Good for: magic systems, political structures, religions, languages, technology, style notes and historical timelines.
check_circle Sanderson's First Law
Brandon Sanderson has argued that how well a magic system can solve your characters' problems depends on how well the reader understands it. If magic solves problems in your story, write its rules down in a Worldbuilding entry. If it's mysterious and atmospheric, you need less.
warning Worldbuilder's Disease
Building world systems is addictive. If you've spent three weeks on your monetary system and haven't written a scene yet, make one Worldbuilding entry with the essentials and start writing. You can always deepen it later.
Event
| Field | Purpose | Example |
|---|---|---|
| Title | Name of the event | The Red Wedding |
| Description | What happened | A massacre at @The Twins during a wedding feast… |
| Significance | Why it matters | Destroyed House Stark's power and broke Northern resistance |
| Sort Date | Used to put events in order | 299 |
| Display Date | The date as you want readers to see it | Year 299, Third Moon |
| Participants | Who was involved | @Robb Stark, @Walder Frey, @Catelyn Stark |
| Location | Where it happened | @The Twins |
| Aliases / Status / Tags | The usual extras | The Betrayal at the Twins |
Tabs: Info | When & Where | Who | Assets
lightbulb Sort Date and Display Date
Sort Date helps order your events. Display Date is the wording you want to see, such as "Year 299, Third Moon" or "Chapter 12". Together they let you keep events in order even in a world with its own calendar. In the list, each event shows its position on your timeline as a number such as #3.
auto_awesome From the Masters: The Red Wedding
Martin's most devastating event works because it's foreshadowed, because the participants are linked to characters whose motives are documented elsewhere, and because the consequences ripple through the whole story. When you create an event, use @mentions in Participants and Location. It builds the web of connections for you.
Linking & Connections
Links are what turn a flat list of entries into a web you can walk through, like a personal wiki for your world.
@Mentions
Type @ in any text field to link to another entry. Two ways work:
@Namefor a short name, such as@Maya@[Full Name]for a longer one, such as@[Katniss Everdeen]
When you type @, a list of matching entries appears. Pick one and the link is added. If the entry doesn't exist yet, pick + Create new character "Name" (or whichever type fits) to make it on the spot. Events don't appear in the @ list. They describe what happens, so you don't mention them inline.
Links follow the entry, not the spelling. Rename an entry and every mention of it updates, wherever it appears.
lightbulb Links added by AI
When AI Enhance or Enrich All writes about other entries in your Bible, it links to them for you. You don't need to add those by hand.
auto_awesome The Magic of Rename
You create a character called "Tom" and mention him in 15 entries. Later you rename him "Thomas Reid." In an ordinary wiki you'd have to find and replace every mention. In WorldKonstruct, every mention updates on its own. Rename with confidence.
Mentioned In
Every entry has a Mentioned In list on its Links tab. It shows every other entry that mentions it. You never create it yourself. It fills in as you write. It answers questions like "Where does this character turn up?" "Which events happen here?" "Who holds this object?"
Relationships
Characters can have formal relationships with each other. On a character's Links tab, add a relationship and WorldKonstruct adds the reverse for you:
- Add "Katniss → Parent of → Primrose" and Primrose gets "Child of → Katniss".
- Add "Aragorn → Spouse of → Arwen" and Arwen gets "Spouse of → Aragorn".
You can choose from fourteen types: Parent of, Child of, Mentor of, Student of, Employer of, Employee of, Sibling of, Spouse of, Friend of, Rival of, Enemy of, Lover of, Colleague of and Associated with.
lightbulb Suggested relationships
When you use Enrich All or AI Enhance, WorldKonstruct may suggest relationships based on what your document says, such as a mentor and their student. It is careful with strong labels like Spouse of or Lover of, and only uses them when the text is clear. You can always change or remove a relationship yourself.
auto_awesome The Web of Story: Percy Jackson
A single character entry for Percy Jackson can connect to a dozen other entries through relationships and @mentions: Poseidon (father), Sally Jackson (mother), Annabeth Chase (partner), Grover (friend), Camp Half-Blood (home), Riptide (weapon), Olympus (faction) and Greek mythology (worldbuilding). Each connection makes your Bible easier to explore.
Relationship graph
See who's connected to whom. Open any saved entry and tap Relationship graph under its name. You'll see a map with that entry in the middle and the entries it's connected to around it: the relationships you've added, the entries you've linked with @, and, for a faction, its members. Lines between the entries around it are drawn too, so you can spot that two of a character's friends already know each other.
Getting around: Find an entry jumps to a name. All, Structured and Mentions let you show every connection, only the relationships and faction members you've recorded, or only the entries linked with @ in a field. Fit to view re-centres the map, Maximise the graph gives it more room, and Back to previous focus returns you to where you were.
The graph only shows connections that are already in your Bible, so a Bible with few links gives a sparse map. It's for looking, not editing. To change a connection, open the entry. Very large Bibles may be too big to draw. The button appears on saved entries, not on one you're still creating.
When it's useful
- Before a scene. Open Elizabeth Bennet before the Netherfield ball and see Jane, Darcy, Bingley, Wickham and Charlotte, and that Wickham and Darcy are already linked.
- Checking your cast. If half the lines run through your detective, every clue and witness reaches the story only through him.
- Finding thin threads. A sister introduced in Chapter 2 with only one line to her needs a story, or a cut.
- Spotting triangles. Katniss, Peeta and Gale: are Peeta and Gale connected, or are there just two separate spokes?
- Coming back after months, or getting a co-writer up to speed.
Download
Your data belongs to you. You can take a copy of your Story Bible outside Google Docs and share it with people who don't have your document.
Download your Bible as an interactive web page
Take your Bible with you. Tap the download download button at the bottom of the sidebar, or go to Settings → Import & Export → Export Your Bible. Both do the same thing. You'll see how many entries and images will be included and roughly how big the file will be and how long it will take. Confirm, and you'll get one web page you can open in any browser.
What's in it
- One file holding your whole world, with no folders to manage.
- Search and filters, and you can tap the links between entries just like in the app.
- Pictures. Main pictures are included in the page when there's room. You can also tap them to see them larger.
- Light and dark reading. There's a switch on the page.
- A look that fits your story. WorldKonstruct picks a style from your story's genre (a parchment style for fantasy, for example). You can't choose it.
It's a reading copy, great for sharing with a beta reader or co-writer. It isn't a backup, and you can't bring it back into WorldKonstruct. Your real backup is your Google Sheet, and Google's version history covers it.
Workflows
Sheets-First Workflow
Your Story Bible lives in a Google Sheet with one tab per entry type. Open it any time from Settings → Open in Google Sheets, or tap Open in Sheets in Quick Edit.
When to use Sheets
- Adding many entries. Ten or more entries are much quicker in rows.
- Bulk editing. Search and replace across your whole Bible.
- Reviewing. See every entry of one type in a table you can sort and filter.
- Co-writing. Several authors can work in the same Bible.
Tips
- Leave the ID column blank for new rows. WorldKonstruct fills it in.
- Use @mentions in cells the same way:
@[Character Name]. - Don't delete or rename the column headings. They tell WorldKonstruct which field is which.
- You can reorder rows freely. Row order doesn't matter in the sidebar.
auto_awesome The Ultimate Architect: J.R.R. Tolkien
Tolkien would have loved working in Sheets. His legendarium was a vast set of cross-referenced genealogies, timelines and word lists. If you like to build the world before the story, the spreadsheet is your main workspace, and the sidebar is where you look things up while you write.
Keeping Sheets & the sidebar up to date
Your changes save on their own. When you edit in the sidebar, WorldKonstruct saves to your Google Sheet in the background. The sidebar also opens quickly because it keeps a copy on your computer. A small badge on an entry means its latest change hasn't reached the Sheet yet. It clears by itself.
Edited your Bible in Google Sheets? Tap the cloud_done sync icon at the top of the sidebar to bring those changes in. They also appear the next time you open the sidebar.
If a change couldn't be saved, Settings shows an Unsaved Changes card. Your work is safe on your computer. See the FAQ for what to do.
Series Support
Share one Bible across several Google Docs. It's ideal for a series, a shared universe, or books told from different points of view.
How to set it up
- Create your Bible in your first document, using any path.
- In your next document, choose Connect it on the setup screen.
- Tap Browse Google Drive, choose the Bible, then tap Link Bible.
- Both documents now share the same Bible.
One Bible for several books? Scan each book's document and give each manuscript its own name. Every entry then shows which books it appears in, and you can rename or review your manuscripts in Settings → Sources. See Manuscripts & Sources.
| Approach | Best For | Trade-off |
|---|---|---|
| Shared Bible | Sequels and other points of view in the same world | Everything is visible in every document. Sources show which book each entry came from. |
| Separate Bibles | Spin-offs and loosely connected worlds | Fully independent, with no links between them. To reuse an entry in another Bible, copy it in Google Sheets. |
auto_awesome A Harry Potter Bible Across Seven Books
Imagine a Bible for seven books: over a hundred characters, dozens of places and magical objects, the Hogwarts houses as factions, and the history of wizarding Britain. That's one Bible shared across seven documents. When you write "Snape" in Book 6, you're looking at the same entry you started in Book 1, with everything you've learned since.
Features & Tools
AI Tools
When you want help filling gaps.
AI Enhance
Open any entry and tap AI Enhance (auto_awesome). It reads your Google Doc for what it says about this entry and fills in the empty fields. Anything you've already written is left alone. It also links to other entries where it mentions them.
- Short fields such as motivation and fear get short answers. Long fields such as backstory get more.
- A deceased character's history is written in the past tense.
- It looks at what's already there. When it writes an appearance, it takes the character's backstory into account.
Name ideas
In Quick Edit for an entry's name, you can ask for name suggestions that fit your world. Pick one to use it, or type your own.
Enrich All
Tap Enrich All at the bottom of the sidebar. WorldKonstruct fills in the empty fields across your whole Bible, using your document and your other entries as context. Before it starts, it shows how many entries and fields it will work on and roughly how long it will take. You can stop at any time. It links to other entries as it goes and may suggest relationships between characters.
lightbulb AI credits
AI features use AI credits. The free plan includes 150 AI credits in total, and Pro has no limit. A scan uses 2 credits, and WorldKonstruct tells you how many you have left before it starts.
Generate Reports
Go to Settings → Reports → Generate Report ("Dramatica story analysis and coaching"). WorldKonstruct reads your Bible and your manuscript and gives you feedback like a story editor who has read everything. Free users get one report in total, and Pro users get unlimited. Dramatica is a well-known theory of story structure, and you don't need to know it to read the report. The report has five tabs:
- Story Coach looks at your story's four main strands: the overall plot, your main character's inner journey, the character who challenges them, and the relationship between the two. It shows how well each is developed and which parts need more scenes.
- Scene Gaps suggests scenes your story seems to be missing. Each one starts with why it's needed, then describes what happens. Create as Event adds it to your Bible.
- Theme looks at the themes in each part of your story, and whether your plot and theme pull the same way.
- Cast Balance checks that the roles in your story (such as protagonist and antagonist) are covered by different characters.
- Character Arcs shows how each character changes, or doesn't, across your events. It warns you when there isn't enough information to say much.
If your document hasn't changed since your last report, the same report loads straight away and a banner offers Regenerate if you want a fresh one.
Visual Assets
When you want pictures on your entries.
Pictures
Every entry can have a round picture. Double-click the picture area on an entry, then paste an image address. WorldKonstruct works with images from most places on the web:
- Google Images is the easiest. Right-click a thumbnail and choose "Copy image address".
- Google Drive. Share the image publicly and paste the share link.
- Imgur, imgBB and Postimages work directly.
- Pinterest. Paste the pin's address and WorldKonstruct finds the picture.
- pCloud and Dropbox. Paste the share link.
- ArtStation, Wikimedia and Fandom wikis work too.
If you can see the picture in your browser, WorldKonstruct can usually show it.
auto_awesome How to grab any image from the web
Right-click the image and choose "Copy image address" (not "Copy image" or "Copy link"). Paste that into the picture box. That's it.
Image gallery
Add more images to any entry on its Assets tab. When an entry has several, tapping its picture opens a viewer you can page through, with captions and an Edit button to change the main picture.
Importing
When you already have notes somewhere else.
Import from other apps
Already have a Story Bible in Obsidian, Notion or Scrivener? Bring it in without retyping. Find the three import buttons in Settings → Import & Export. (To take a copy out, see Download your Bible.)
| Source | What to upload | How it works |
|---|---|---|
| Obsidian | Your vault as a .zip | Reads your notes. Folder names such as Characters and Places tell WorldKonstruct what each note is. Your links carry over. |
| Notion | Your Notion export as a .zip. In Notion, export as Markdown & CSV. | Database pages and stand-alone pages both come in. WorldKonstruct works out what type each page is. |
| Scrivener | Your .scriv project folder as a .zip | Reads your binder and the notes in it. Research items become Worldbuilding entries. Items with only a title still come in as stubs, so you can fill them in later. |
How importing works
- Tap the import button for your app.
- Drag your
.zipfile in (or tap to browse). - Review what was found. It's the same kind of review screen as a scan, with a tick box for each item.
- Untick anything you don't want, then tap Import N.
lightbulb Smart importing
- Picture addresses in your notes go to the entry's picture and images, and other web links go to its Assets tab.
- Duplicates are merged. If the same entry appears twice, the fuller version wins, field by field.
- Headings such as "Backstory" or "Appearance" in your notes are matched to the right fields.
Search and filtering
Type in the search bar to find entries across every type, with a short preview of where the text appears. Use the category buttons to look at one type. You can combine them: search inside one type, or across all.
If something goes wrong
- Refresh: tap the sync icon at the top of the sidebar, or close and reopen the sidebar.
- Undo a change: in Google Sheets, use File → Version history.
Entry Management
When you want to keep your entries organized.
Aliases
Any entry can have several names. Add them to the Aliases field, separated by commas. Scans use them to recognize the same character under different names, and typing any alias after @ finds the entry.
Deceased and Missing
Mark a character Deceased or Missing in their Status. The status shows in the entry list, and when AI fills in a deceased character's fields it writes about them in the past tense and skips motivation and fear.
Story context
You don't set up a genre or tone. When you scan your document, WorldKonstruct works out your story's genre and setting on its own and uses that to keep suggestions in tune with your story.
Settings
Tap the settings gear at the top of the sidebar. You'll find:
- Connected Bible shows your Bible's name and Open in Google Sheets.
- Sources lists the manuscripts that contribute to your Bible, and lets you rename them.
- Unsaved Changes appears only when a change couldn't be saved.
- License shows your plan and how many entries you've used. See Licensing.
- Import & Export has Export Your Bible and the Obsidian, Notion and Scrivener importers.
- Reports has Generate Report.
- Connection has Disconnect Bible, which unlinks this document. Your Google Sheet isn't deleted.
- Privacy Policy is a link to our full policy.
Your Data & AI
AI is a big part of WorldKonstruct. Here's how it works and where your material lives. For the legal detail, see the Privacy Policy.
What's sent to the AI
When you use an AI feature, the text it needs is sent to Google's Gemini AI to get an answer:
- Scanning: your document text (in sections, for a long one).
- AI Enhance and Enrich All: your document text and the entries being filled in.
- Name ideas: the kind of entry and the names you already have.
- Importing from Obsidian, Notion or Scrivener: the text of your notes, only when WorldKonstruct needs help deciding what type an item is.
The AI is used on a paid business plan, where Google doesn't keep what's sent or use it to train its models.
What's not sent to the AI
- Your Google account details
- The link to your Google Sheet
- Your pictures
Where your data lives
| What | Where it lives | Who controls it |
|---|---|---|
| Your entries and fields | A Google Sheet in your own Google Drive | You |
| A copy for opening quickly | Your own computer, in your browser | You |
| Your pictures | Wherever you hosted them (Google Images, Imgur, Google Drive and so on) | You |
| Your licence | Looked up by your email address | You and WorldKonstruct |
WorldKonstruct doesn't keep your story text on its own servers.
Licensing
| Feature | Free | Pro ($79, one time) |
|---|---|---|
| Entries | 150 entries, plus a 10-entry grace allowance | Unlimited |
| AI credits | 150 in total | Unlimited |
| All features | ✓ Full access | ✓ Full access |
| Generate Report | 1 report in total | Unlimited |
| Updates | All updates | Lifetime updates |
To upgrade, go to Settings → License → Upgrade - $79. After you've paid, tap Refresh License to switch on Pro right away. Already bought? Use Already purchased?. The counter at the top of the sidebar (for example 142/150) shows how many entries you've used.
Troubleshooting & FAQ
auto_awesome The Big Questions Every Writer Asks
How detailed should my entries be?
Detailed enough to prevent contradictions, sparse enough to stay flexible. In a first draft, a sentence per field is fine. Deepen entries as your story settles.
When should I start my Bible?
Now. If you're mid-draft, choose I have pages already written to catch up. If you're at page one, choose I want to build it myself. The best time is before you need it.
What if my story changes?
It will. Your Bible is a living document, not a contract. Edit entries as you go, and rename characters with confidence, because mentions update automatically.
In a Google Sheet on your Google Drive. WorldKonstruct creates it when you set up your Bible. You own it completely, and you can open, edit, share or delete it like any other Google Sheet.
Partly. The sidebar keeps a copy of your entries on your computer, so you can browse them without a connection. Editing, saving to your Sheet and AI features need the internet.
Yes. First share the Bible's Google Sheet with them, using Google Sheets' normal sharing, because they can't see it until you do. Then each author chooses Connect it in their own document, taps Browse Google Drive, picks the shared Bible and taps Link Bible. Everyone works in the same Bible.
Yes. In Quick Edit you can use **bold**, *italic*, - list items and headings (type ##, a space, then the heading, like ## Chapter Notes). The formatting shows when the field is closed, and you edit the plain text when it's open.
Yes. Open the entry and tap the type label at the top (for example "Character"), then choose the new type. Details the new type has no field for are kept in a Previous details section on the entry.
Tap the cloud_done sync icon at the top of the sidebar. If entries still don't appear, close and reopen the sidebar, then refresh your document.
The entry has a change that hasn't reached your Google Sheet yet. That's normal, and it clears by itself. If it stays for more than a minute, check your internet connection or tap the sync icon.
It means a change couldn't be saved (for example, your connection dropped). Your work is safe on your computer. Tap Retry Failed to try again. Only tap Discard Failed Changes if you're sure you don't need them.
You might also see Changes From an Earlier Version. These are changes that were held back. Tap Save to This Story Bible to keep them, or Discard Held Changes if you don't want them.
Google lets you untick individual permissions when you install an add-on, and WorldKonstruct needs all of them to open your Bible. Tap Authorize WorldKonstruct, tick every permission, then come back and tap Continue.
This usually means WorldKonstruct can't reach your Bible's Google Sheet. Try this:
- Close the sidebar and open it again from Extensions → WorldKonstruct.
- Make sure you're signed in to the Google account that owns or can open the Sheet.
- If the Bible is shared, check that its owner hasn't removed your access.
A very large Bible can take a little while the first time it opens. If it keeps failing:
- Check your internet connection.
- Close and reopen the sidebar, then refresh the document.
If Google says it's getting too many requests at once, wait a minute and it will carry on. Your work isn't lost.
Check that:
- The entry exists in your Bible (try searching for it).
- For longer names you used brackets:
@[Katniss Everdeen]. - The name is spelled the same way.
- You picked the entry from the list that appears when you type
@.
WorldKonstruct noticed two entries with very similar names, such as "Jon Snow" and "John Snow". Tap the tag to jump to the other entry. If they're meant to be different (a father and son with the same name, say), you can ignore it. It goes away if you make the names or aliases clearly different.
The graph only opens for entries that are saved, so wait a moment if you've only just created it. Very large Bibles may be too big to draw. Tap Reload from the Story Bible if you see "Could not load the graph".
Use Google Sheets' version history: File → Version history → See version history. Find a version from before the deletion and restore it. WorldKonstruct picks the columns back up.
Not yet. Each type of entry has a fixed set of fields. Extra columns in your Sheet won't break anything, but they won't show in the sidebar. Use Tags for your own labels and the text fields for extra notes.
Pictures come from an image address you paste in. If one doesn't show:
- Right-click the image and choose "Copy image address". Don't use "Copy image" or "Copy link address".
- Google Images is the easiest source.
- Avoid addresses from Discord or AI image tools, which often stop working after a few hours.
- Google Drive images must be shared as "Anyone with the link".
Your Bible already has a manuscript in it, and you're scanning a different document. WorldKonstruct asks you to Add another manuscript so every entry can show which book it came from. Type a name such as Book 2. You can rename it any time in Settings → Sources.
A possible match is something the scan found that might be an entry you already have under a different name. Nothing happens to it unless you tap Use existing. Tap Ignore to leave it alone.
WorldKonstruct remembers your last scan. If your document hasn't changed since then, you'll see "Your bible is up to date — no document changes detected." Nothing is scanned and no AI credits are used.
Common reasons:
- The document is very short.
- Everything in it is already in your Bible.
- The document has no named characters or places.
- You ticked Remember items I explicitly skip earlier. Untick it and scan again.
It suggests scenes your story seems to be missing, based on your Bible and manuscript. Each suggestion says why the scene is needed, describes what happens, and has a Create as Event button to add it to your Bible. Find it in Settings → Reports → Generate Report, on the Scene Gaps tab.
The more it has to go on, the better it does:
- Write more in your document. WorldKonstruct works out your genre, tone and setting from it.
- Build entries first. The AI uses your existing entries as context, so early entries improve later ones.
- Add a few details yourself. Then tap AI Enhance to fill the rest.
Go to Settings → Connection → Disconnect Bible. It unlinks this document; your Google Sheet isn't deleted, and other documents connected to the same Bible aren't affected. Disconnecting doesn't copy your entries anywhere. To keep a separate copy, make a copy of the Sheet in Google Sheets first, then link the copy.
Still Need Help?
If you can't find an answer:
- Search this guide. Use Ctrl+F (or Cmd+F) to find a word.
- Start fresh. Close the sidebar, refresh your document and open WorldKonstruct again.
- Contact support through the link in the page footer.
lightbulb Before you contact support
It helps us help you faster if you can tell us:
• Your browser and version
• The message you saw, if any
• What you were doing
• A screenshot, if you can