Importing

If you've been writing somewhere else, your manuscript and lore files need to come over before you can carry on. Import uploads several files or a whole folder at once and turns the manuscript into chapters and the lore into document pages.

Say Vincent's story lives in four files: Chapter 1.txt, Chapter 2.txt, Chapter 10.txt, and Characters.docx. Upload them together, and the three chapters come in as manuscript chapters and the character notes as a document page.

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: While there's no manuscript yet, use Upload files in We'll help you get started on the manuscript screen. Files in Your story go to the manuscript, and files in Lore & notes go to Documents. (Getting Started)
• The sidebar's Manuscript tab: Import in the Add menu. Files go to the manuscript you have selected.
• The sidebar's Documents tab: Import in the Add 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.

One file becomes one page however long it is, named after the file without the extension. The four files in the example become four pages: Chapter 1, Chapter 2, Chapter 10, and Characters.

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, and files in the documents box become document pages. If you uploaded a folder, its structure is recreated in the document pages; chapters get no folders.

1. If a file landed in the wrong box, hover its row and press To documents or To manuscript, or drag the row to the other box.
2. At the right of the manuscript box's header, choose which manuscript the files go into. Choosing Create manuscript makes a new one.

A file whose content doesn't fit its box moves to the box it fits. A planning memo dropped in the manuscript box goes to the documents box, an episode dropped in the documents box goes to the manuscript box, and a moved file shows Moved based on its content next to its name. When you add files, Sorting files into the manuscript and documents based on their content appears at the top of the window, and each file joins a box once its content has been checked. Move a file back by hand and it stays where you put it.

If you opened the window from a new Space's chat, files with consecutive numbers in their names are already sorted into the manuscript, and the rest into documents. In the example, Chapter 1, 2, and 10 sit in the manuscript box and Characters in the documents box. A single file goes to the manuscript box.

Putting chapters in order

The manuscript box orders files by the number in their names. The example's three files appear as 1, 2, 10, and files without a number come after them. Drag a row to change the order.

Chapter numbers continue from the chosen manuscript's last chapter, in this order. In an empty manuscript, Chapter 1, 2, and 10 become chapters 01, 02, and 03.

Finishing the import

The button at the bottom of the window shows what will come in — in the example, Import 3 chapters · 1 document.

1. Press the button. The files upload one at a time, and each row's progress bar fills as it goes.
2. When everything is in, the window closes and the new chapters and pages appear in the sidebar.

Closing the window with Close doesn't stop the import. To stop it, press Stop. The file currently uploading still goes in, and files already imported stay.

Putting imported writing into the World

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)

To put it into the World right away, check Organize World with the imported files at the bottom of the window before you press the import button. When the import finishes, World organizing starts on the chapters and documents this window created.

Before organizing, the agent looks through each document and puts only the ones with lore, such as characters or places, into the World. In the example, Characters goes into the World. Documents without lore are left out, and their names appear in a notification when organizing finishes.

Putting a file into the page you have open

1. Press Import to page in the editor's More menu at the top and pick one file.
2. If the page has writing, choose Overwrite current page or Import as new page. On an empty page, Import alone fills it right away.

Attaching a file in the chat

The + (Attach file) in the chat input opens the same window. Pick one of the 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 are attached; for a longer file, only the beginning is used.

FAQ

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 give each chapter its own page, split the file by chapter before uploading.

Does the formatting in my files come along?

Bold, italics, headings, and lists in .docx, .md, and .html files come along. Fonts, font sizes, and colors in .docx files don't; the text shows in your editor font. If you've turned on auto-conversion for quotes, dialogue dashes, or ellipses, it applies to imported text too. (Formatting)