Import a book, documents, or an Authorship export

All help articles

Your first book

Before you have a project, Recent projects on Home offers two ways to begin:

  • Start a new book: choose New project and name it.
  • Bring in your draft: choose Choose files, or drop your files on it, then follow Start a project from a book or an export. You can bring in Word (.docx), OpenDocument (.odt), RTF (.rtf), Markdown (.md), plain text (.txt), PDF (.pdf), web page (.html), Pages (.pages), or EPUB (.epub) files, a whole folder of chapters, a ZIP of them, or a Scrivener project, or choose Paste your manuscript.

Every new book opens beside its Welcome chat, the first chat in your chat list. It offers a few ways to start. Choose one to see what it does.

A book you imported offers:

  • Pick up where you left off opens your last chapter, shows how it ends with a play button to hear it read aloud, and summarizes the chapter.
  • Brainstorm what comes next starts brainstorming with you.
  • See the big picture opens your Story Atlas, and chat gives you a tour of it. If your book doesn't have one yet, it's built from your chapters and appears in Files as it's saved.

Pick up where you left off and See the big picture need Read my book. If it's off, choosing either one asks for it right there, then carries on.

A book you started from scratch opens on Chapter 1, ready for you to write or paste in what you have. Its Welcome chat offers Start in Chapter 1, Brainstorm a new idea, and requests you can send with one click, such as asking for a few prompts for your first words.

When no file is open, the editor shows your book's page: your latest writing, ways to add a chapter, a note or more files, and More to try, a short list of guides and tools.

You can come back to the Welcome chat anytime, or delete it like any other chat. To hear any other passage, select text, choose Play aloud, then press the passage's play button.

Import into a project

  1. In the editor, choose Add file or folder, then Import. You can also drag files or a folder from your computer onto the file tree. Drop them on a folder to import into that folder.
  2. Choose Word (.docx), OpenDocument (.odt), RTF (.rtf), Markdown (.md), plain text (.txt), PDF (.pdf), web page (.html), Pages (.pages), or EPUB (.epub) files, images, a whole folder, a ZIP, or a Scrivener project. For a Google Doc, paste its link into Google Docs link and choose Add link. To paste your chapters instead, choose Paste your manuscript. Then choose Find chapters.
  3. Authorship finds your chapters, including every chapter of a whole book kept in one file. This usually takes under a minute; a long book can take two.
  4. Review the chapters and notes in reading order. Each shows its title, word count, and first line. Notes show their role in the book or Not in the book. Those notes still import into Files. Titles come from your own headings, so "Chapter 1: Seaside Blooms" becomes Seaside Blooms. A section without a heading is named after its file or its first line. You can:
    • Rename a chapter or note.
    • Switch a section between Chapter and Note.
    • Choose Merge into previous to join a section to the one before it, and Undo to split it again.
    • Choose Keep as one file to import a file without splitting it.
    • Choose Skip this file to leave a file out.
    • Choose Rename folder or Don't make a folder. A file that holds several chapters gets its own folder, named after the book.
  5. Choose the button that names what you're adding, such as Import 12 chapters. When it finishes, choose Open first chapter.

Nothing is added until you import, and existing writing is never replaced. Chapters join the manuscript in reading order. Front and back matter, such as a dedication or acknowledgments, come in as notes. The import is done once every chapter and note is saved.

Start a project from a book or an export

  1. On the dashboard or the Projects page, choose Import. It's there even before you have a project.
  2. Choose a book's DOCX, ODT, RTF, Markdown, plain text, PDF, HTML, Pages, or EPUB files, a folder or ZIP of them, or a Scrivener project. You can also paste it with Paste your manuscript. Choose Find chapters, and review it as above. The new project takes the book's name; change it under Project name. The imported chapters, notes, images, and subfolders go inside an expanded Manuscript folder. A folder you choose names the project, and its subfolders stay inside Manuscript.
  3. Import, then choose Open project.

To restore a project from an Authorship export, choose its ZIP instead. Authorship knows an export by what it holds, so a ZIP you renamed still restores, and any other ZIP opens into its files. Authorship shows what the export holds and a suggested name. Choose Restore project, then Open project once it reads Imported. A restore always creates a new project and doesn't merge into an existing one. You can run one restore at a time. When it finishes, it lists anything it couldn't restore exactly.

What comes back from an export

  • Exports from October 2026 onward bring back each chapter and note as it was, including tables, checklists, toggle lists, epigraphs, alignment, links, and highlight colors. If you edited a Word document inside the ZIP before importing, that file comes from your Word document instead, with the same limits as older exports.
  • Older exports bring back the text and basic formatting in their Word documents. Tables and toggle lists become plain paragraphs, checklists become bulleted lists, and alignment and highlight colors are lost. Export the project again for a closer copy.
  • Exports from September 2026 onward keep your folder names, file order, empty folders, and manuscripts with their chapters in order. Earlier exports put every chapter in one manuscript.
  • A chapter or note that was in a manuscript after being deleted from the file tree comes back the same way: it stays in the manuscript and opens from the Manuscript panel, but it isn't in the file tree.
  • A chapter or note that had no saved content when it was exported, such as one that was never opened, is created empty in its original place.
  • Comments, version history, todo boards, nouns, goals, and collaborators aren't part of an export, so they aren't imported.

Paste your manuscript

You can paste chapters instead of choosing a file, from Google Docs, Word, LibreOffice, or any other app you write in.

  1. In your writing app, select the chapters you want and copy them. To copy a whole document, select all first.
  2. In Import, choose Paste your manuscript, then paste into the box: press Command+V on a Mac or Ctrl+V on Windows, or on a phone or tablet, touch and hold the box and choose Paste.
  3. The paste is listed as Pasted manuscript, like a file you chose. Paste again to add more, or choose Find chapters and review the chapters as above.

A paste keeps the same headings, italics, quotes, and section breaks that a web page does, so headings you use for chapters still mark where they start. Text copied without formatting comes in one paragraph per line. Pictures don't come with a paste, because Google Docs and Word copy them as links; the review counts them. To keep pictures, import the .docx file instead.

A paste can be up to 20 MB. If yours is larger, paste fewer chapters at a time, or import the document file. A paste with no text, such as only a picture, isn't added.

Formats and limits

  • Word (.docx), OpenDocument (.odt), PDF (.pdf), Pages (.pages), EPUB (.epub), and Scrivener documents can be up to 200 MB, pictures included. RTF (.rtf), Markdown (.md or .markdown), plain text (.txt), and web page (.html or .htm) documents can be up to 20 MB; save a larger RTF file with pictures as Word (.docx) first. PNG, JPEG, WebP, and GIF images can be up to 10 MB. One import holds up to 1,000 files and 200 MB. A document can hold up to 10 million characters, about 1.7 million words, in up to 200,000 paragraphs. Other files stay listed with an explanation and aren't imported. Save .doc files as .docx first.
  • A Google Doc comes in from its link when its sharing is set to Anyone with the link, which lets anyone with the link read it; set it back to Restricted once the import finishes. It can be up to 200 MB as a Word file. Its comments and footnotes aren't imported. Accept or reject suggestions first. You can also download it as a .docx and import that file.
  • A folder keeps its nesting. Empty folders are left out.
  • A ZIP opens into the files it holds, in their folders, as if you had chosen the folder it was made from. Its files count toward the 1,000-file and 200 MB limits, and files Import can't read stay listed with an explanation. Hidden files and the extra files macOS and Windows add are left out. A ZIP inside a ZIP isn't opened: unzip it and choose what it holds. A ZIP that's damaged or has a password can't be opened either. An Authorship export ZIP restores a project instead, from Import on the dashboard or Projects page.
  • A Pages document saved as a package folder imports as one file, whether you drop it or choose its folder. Text boxes, shapes, and charts in a Pages document are left out; text in an inline text box comes in after the paragraph it sits in. Import can't read a Pages page layout document, one saved by Pages '09 or earlier, or a password-protected one. In Pages, choose File > Export To > Word and import the Word file instead.
  • A Scrivener project comes in as one book: choose its .scriv folder with Choose a folder, drag it in, or choose a ZIP of it. Its Draft folder comes in, in binder order. Each binder title becomes a chapter, and a folder of chapters, such as Act 1, becomes a part title. Documents not included in compile, Research, Trash, synopses, document notes, labels, and snapshots stay out, and the review counts what's left out. Projects from Scrivener 1 need opening in Scrivener 3 first.
  • Image files become images in the file tree. Pictures inside a document are kept in notes but left out of chapters, so make a section a Note to keep its pictures. From an RTF file, only PNG and JPEG pictures come in, and the review counts the others.
  • In a web page or EPUB, a footnote linked to its marker is kept as text: the marker reads [1], and the note follows at the end of its chapter, even when the book keeps every note at the end. Other footnotes, endnotes, and comments aren't imported; the text around them is. Tables come in as plain paragraphs, except in Pages documents, where they're left out. The review lists what each file leaves out, such as 3 footnotes, before you import.
  • A paragraph of only three or more asterisks (with optional spaces), #, or ⁂ becomes a Section break, and so does a horizontal line in an RTF file. Page breaks don't leave empty paragraphs behind; text beside a page break stays.
  • Markdown keeps its headings, italics, bold, links, block quotes, lists, and section breaks such as *** or ---. Front matter at the top of the file is left out, and so are footnotes and HTML comments; the review lists them. Other HTML in the file comes in as its text. A picture written into the file comes in like a picture in a document. A picture linked by its path, such as ![Map](map.jpg), is a separate file: import it alongside, or add it to a note afterwards.
  • Plain text has no headings or formatting, so _underscores_ and *asterisks* stay as you typed them. Paragraphs can be separated by blank lines, sit one per line, or be wrapped at a fixed width, which is joined back up. A line of ***, * * *, #, or ~ becomes a Section break, and indented passages become block quotes. Lines such as Chapter 12, Prologue, or Interlude 2 start chapters, so check chapter titles in review. UTF-8, UTF-16, and older Windows text files are read.
  • A PDF holds pages, not paragraphs, so Authorship rebuilds paragraphs from where the text sits on each page, and the review asks you to check chapter starts, paragraph breaks and italics. Page numbers, running headers and footers, and footnotes are left out, and a word split across two lines with a hyphen is joined when the whole word appears elsewhere in the book. Italic and bold come through when the PDF's fonts name them, and a line drawn between paragraphs becomes a Section break. Pages in two columns are read left column first. Use a .docx or .odt copy when you have one. A scanned PDF has no text to import, and a PDF that has a password or doesn't allow copying its text can't be imported.
  • A web page saved from Word, LibreOffice, Google Docs, or a browser keeps its headings, italics, quotes, and section breaks. Pictures saved inside the page come in. Pictures linked from the web are never downloaded, and pictures saved in a folder beside the page aren't imported unless the page and its folder come in one ZIP; the review counts the rest. Scripts, forms, and page headers and footers are left out. Google Docs' Web page download is a ZIP holding the page and its pictures: choose the ZIP, and the pictures the page shows come in with it.
  • An EPUB from Vellum, Atticus, Kindle Create, Calibre, or a past release keeps its chapters, headings, italics, quotes, and section breaks, in reading order. Chapter titles come from its table of contents when a chapter has no heading. Its cover opens the book as a picture. A copy-protected (DRM) EPUB can't be read, so import a copy without DRM, such as the file your writing app exports.
  • Your words come in exactly as written. Review changes where chapters start and what they're called, never the text.

Come back to an import

  • Closing the dialog or leaving the page doesn't stop an import. Choose Import again to return to it: a review keeps your changes, and an import in progress shows how far it has got. On the dashboard and Projects page, choose Continue on your import; you can still restore an export ZIP there meanwhile.
  • While a book imports into a new project, it's the first row of Recent projects on the dashboard and of the Projects page, with how far it has got. It opens like any other project once its chapters are saved. When its chapters are ready to check, or the import didn't finish, choose Review your chapters or See what happened on that row.
  • You can run one import at a time. Finish it or choose Discard import before starting another. A review left unchanged for 7 days expires.
  • If an import doesn't finish, choose Retry. Files it already created are kept, and nothing is added twice. Start over begins a new import.
  • You can start up to 20 imports in 24 hours.