Skip to content

Link or import? Edit a Paratext project in place or clone it

Linking keeps Aquilla connected to the Paratext project on your computer, so your edits go back into the same Paratext files. Importing (cloning) makes a one-time copy inside Aquilla, and the copy does not know about Paratext afterwards. Choose linking when your team keeps working in Paratext. Choose importing when you want to move the work into Aquilla.

Question Link: edit in place Link: Open in Aquilla Import (clone)
Does my edit change the Paratext files? Yes, when you choose Write to Paratext Yes, when you choose Write to Paratext No
Do Paratext changes appear in Aquilla? Yes, while the book is open Yes, while the book is open No, unless you import again
Can I use AI drafting and the agent? No Yes Yes
Does the text leave my computer? No Yes, to your Aquilla organization Yes, to your Aquilla organization
Can teammates without the desktop app work on it? No Yes, in the project, but only your computer writes to Paratext Yes
Does Send/Receive carry my edits? Yes, run it in Paratext Yes, run it in Paratext Not applicable
Where do I start? This computer → Paratext projects → your project → pick a book This computer → Paratext projects → your project → Open project Import → Upload files → Paratext project

Edit in place opens a book from the Paratext project folder on your computer and shows each verse, heading and introduction paragraph as a line to edit. Nothing is uploaded.

  1. Open the Aquilla desktop app and choose This computer → Paratext projects.
  2. Choose your project, then pick a book on its page.
  3. Edit the lines. Choose Write to Paratext when you are ready.
  4. Run Send/Receive in Paratext.

This editor is plain on purpose. It has no AI drafting, because the text never leaves your computer. It is the right tool for fixing typos, checking a passage and adding a note. The full steps are in Working on your Paratext projects.

Option 2: Open in Aquilla (a linked project)

Section titled “Option 2: Open in Aquilla (a linked project)”

Open in Aquilla creates a regular Aquilla project that stays linked to the Paratext project. You get the whole Aquilla editor, including AI drafting, back-translation, health scores, comments and the AI agent. The link works in both directions:

  • Paratext to Aquilla. Aquilla watches the project folder. When Paratext or Send/Receive changes a book that you have open, the change appears in the Aquilla project.
  • Aquilla to Paratext. The save button in the editor header counts the edits that Paratext does not hold yet. Open it and choose Write to Paratext to put them in the Paratext book file.

How to do it:

  1. Sign in to the Aquilla desktop app.
  2. Choose This computer → Paratext projects.
  3. Choose your project, then Open project on its page.
  4. Pick a source Bible for the drafting side. Aquilla reads the books and creates the project in your organization.
  5. Work in the editor. Look for the Paratext badge in the header.

If you already opened this Paratext project in Aquilla, Open project takes you straight to the existing project. It does not make a second copy.

An import reads the Paratext books once and stores them in an Aquilla project. After that, Aquilla and Paratext are two separate copies. Edits in one never reach the other.

  1. In an Aquilla project, choose Import in the editor header.
  2. Choose New source text → Upload files.
  3. Drop the Paratext project as a folder or .zip file.
  4. Aquilla asks whether the project comes in as Source text or as a Translation in progress. Choose the one that matches your use.
  5. Review the preview. You can untick books you do not want. Then confirm.

See Importing for the full list of formats. Import works in the browser, so it is the right option when you cannot install the desktop app or when the Paratext project lives on another person’s computer. To get the work back into Paratext later, use Exporting your work to make USFM files, then bring them into Paratext yourself.

  • Your team stays in Paratext and you want AI help: Open in Aquilla.
  • You want to fix a few verses or add notes and nothing more: edit in place.
  • You are moving the project into Aquilla for good: import.
  • You want a reference text, not a working project: import it as Source text, or link it as a source. See Source projects.
  • Your Paratext project lives on a computer you cannot use: import a zip.

You can use more than one. Many people link a project for daily work and import a second project as a source text to draft from.

  • Paratext stays the master for the text, the history and the permissions.
  • Aquilla never runs Send/Receive and never touches the project history.
  • Aquilla writes only into the book file you edit and your own notes file.

See Send/Receive and Paratext’s memory.