Importing

Upload the manuscript and lore files you already have, and turn them into manuscript chapters and document pages. Upload several files or a whole folder at once, sort out in the window which are manuscript and which are documents, then import.

Opening the Import window

The Import window opens from several places, and where you open it decides where the files go to begin with.

  • A new Space's chat: While there are no manuscript pages yet, the chat's Here's how to start has an Import button. Opened from here, the files arrive already sorted into manuscript and documents by their names.
  • The sidebar's Manuscript tab: Import in the Create new menu. Files go to the manuscript you have selected.
  • The sidebar's Documents tab: Import in the Create new menu. Files go to Documents. Open it from Import in a folder's ⋯ and they go into that folder.

Uploading files

Drop files or folders onto the window, or press Upload files or Upload folder to pick them. Files you add later join the list. Phones have no Upload folder.

  • .txt, .docx, .md, and .html files (.htm works too) are accepted, up to 50MB each.
  • One file becomes one page however long it is. The page is named after the file, without the extension.
  • In a .txt file, each line becomes a paragraph and blank lines are dropped.

Sorting files into manuscript and documents

Once files are in, the window shows two boxes, Manuscript and Documents. Files in the manuscript box become chapters; files in the documents box become document pages.

  • Hover a row and press To documents or To manuscript, or drag the row to the other box. The ✕ only takes the file off the list.
  • If you opened the window from a new Space's chat, files whose names carry a running number go to the manuscript first and the rest to documents. A single file goes to the manuscript.
  • Choose which manuscript to fill at the right of the manuscript box's header. Choosing Create manuscript makes a new one.
  • Files bound for documents land where you opened the window (the top of Documents or the chosen folder), and an uploaded folder's structure is recreated. Files bound for the manuscript get no folders.

Chapter order and numbers

The manuscript box lines files up by the running number in their names. Chapter 1, Chapter 2, Chapter 10 come out as 1, 2, 10, and files outside that run follow after them. Drag a row to change the order.

Chapter numbers continue from the chosen manuscript's last chapter, in this order. A number in a file name does not become the chapter number: importing 05.txt alone into an empty manuscript makes chapter 01, titled 05. Change numbers after importing with Change number. (See Manuscript.)

After you press Import

The button at the bottom of the window shows what will come in, like Import 3 chapters · 1 document. Press it and the files go up one at a time, each row filling a progress bar.

  • When everything is in, the window closes and the new chapters and pages appear in the sidebar.
  • Closing the window with Close does not stop the import. To stop it, press Stop — the file going up finishes, and what is already in stays.
  • If some files could not be imported, the window stays open with only those files, each with its reason. Press the button again to retry just those.

Chapters imported into the manuscript count as chapters the World hasn't read yet, and show in World backlog below the chat input. Press Organize there and their characters, places, and lore go into the World. (Organize World)

Putting a file into the page you have open

To fill the open page with a file, open Import to page in the editor's More menu at the top. Pick one file at a time.

  • If the page has writing, choose Overwrite current page or Import as new page. Overwriting asks once more, and the writing it replaces stays in History so you can bring it back. (History)
  • Importing as a new page creates a page named after the file at the top of Documents.
  • An empty page fills straight away with Import.

Attaching a file in the chat

The + (Attach file) in the chat input opens the same window, with two buttons at the bottom.

  • Save to manuscript/document: Turns the files into manuscript or document pages and attaches those pages to your message.
  • Attach as reference: Attaches only the files' text to your message, without making pages. Up to 100,000 characters per file come along; anything longer is cut.
Can I import Hangul (.hwp) or PDF files?

No. .hwp, .pdf, .doc, and .rtf files are not accepted. Save the file as .docx or .txt in the program you wrote it in, then import it.

What if one file holds several chapters?

One file becomes one chapter. To make each chapter its own, split the file by chapter before uploading.