Skip to content

Paratext and Aquilla: frequently asked questions

These are the questions that translators and project leads ask most about Aquilla and Paratext. Each answer starts with the short version. The links go to the full page.

Open the project in the Aquilla desktop app with Open in Aquilla. You get AI drafting, back-translation, checks and an AI agent. Your accepted edits go back into the Paratext project folder with Write to Paratext, and Paratext’s Send/Receive carries them to your team. See How can I use AI for my Paratext project?.

Can I edit a Paratext project in Aquilla without importing it?

Section titled “Can I edit a Paratext project in Aquilla without importing it?”

Yes. In the desktop app, choose This computer → Paratext projects, pick a book and edit it. Aquilla writes your changes into the Paratext book file. Nothing is uploaded. See Link or import?.

What is the difference between linking and importing a Paratext project?

Section titled “What is the difference between linking and importing a Paratext project?”

Linking keeps Aquilla connected to the Paratext files on your computer, so your edits go back to Paratext and Paratext’s changes come to Aquilla. Importing makes a one-time copy in Aquilla that is not connected to Paratext afterwards. See Link or import?.

It is a workspace in the desktop app that lists the folders and Paratext projects on your device. Aquilla searches the places Paratext uses and any folder you add. See What is “This computer”?.

Which Paratext versions and computers work?

Section titled “Which Paratext versions and computers work?”

Aquilla is tested with Paratext 9 projects that use UTF-8, which is the Paratext default. It needs the Aquilla desktop app to read the project folder. It also looks in the folders Paratext 10 and Paratext Lite use by default, and finds Paratext 9 projects that were installed under Wine on a Mac. A project in another encoding shows “This project is not UTF-8; the bridge cannot edit it yet.”

Only in part. A browser cannot read your Paratext project folder, so linking and editing in place need the desktop app. In the browser, you can still import a Paratext project as a folder or .zip file. See Importing.

Can I send and receive with Paratext through Aquilla?

Section titled “Can I send and receive with Paratext through Aquilla?”

No. Aquilla does not run Send/Receive. Aquilla writes to the project files on your computer, and you run Send/Receive in Paratext. Your team gets the edits the same way as any other Paratext edit. See Send/Receive and Paratext’s memory.

Why does my edit disappear when Paratext is open?

Section titled “Why does my edit disappear when Paratext is open?”

Paratext keeps open books in memory and saves from that copy. If Aquilla wrote to the book after Paratext loaded it, Paratext’s next save can put the old text back. Aquilla notices this, keeps your version, and shows a window to choose Keep mine or Take theirs. Close the book in Paratext before you write to avoid it.

What happens if my teammate and I change the same verse?

Section titled “What happens if my teammate and I change the same verse?”

Aquilla shows Paratext changed this too with three versions: When you opened it, Paratext now and Yours. You pick one for each verse. Aquilla never overwrites a verse in silence.

Aquilla keeps a copy of the previous book file outside the project folder every time it writes. Paratext’s Project History also records each change after Send/Receive. See If something goes wrong.

Can I add notes to my Paratext project from Aquilla?

Section titled “Can I add notes to my Paratext project from Aquilla?”

Yes, in the edit-in-place book editor. Each line has a speech-bubble button. Choose it, write the note, and choose Add note in Paratext. The note is written into your own Paratext notes file, so it shows in Paratext’s Notes list and travels with Send/Receive. Aquilla shows only your own notes, and it cannot edit, reply to or resolve notes. Those stay in Paratext.

Can I see my teammates’ notes in Aquilla?

Section titled “Can I see my teammates’ notes in Aquilla?”

No. Aquilla shows Showing your notes only. Notes from other team members are in Paratext.

Yes. Before every write, Aquilla checks the book and chapter permissions that Paratext holds for your user. If Paratext has not given you the book, Aquilla shows the book as Read only and writes nothing. If Aquilla cannot tell who is registered in Paratext on the computer, it does not write.

Aquilla is built to prevent that. It changes only the words you edited, checks its own result before it saves, refuses to save if more than your edits changed, holds back footnote and cross reference changes until you confirm them, and keeps a copy of the previous file. Keep using Send/Receive and Project History as your safety net.

Action Where the text is
Edit in place Only in your Paratext project folder
Open in Aquilla In your Paratext folder and in a project in your Aquilla organization
Import In a project in your Aquilla organization

Text goes to an AI service only when you use an AI feature on it.

Aquilla can be your working tool for drafting, review and audio, and it can hold a full project. Teams that share a project through Paratext keep Paratext as the master for text, history and permissions, and use Aquilla next to it. Choose by how your team works. See Link or import?.

Can Aquilla run the checks I run in Paratext?

Section titled “Can Aquilla run the checks I run in Paratext?”

Most of them. Aquilla checks chapter and verse numbers, markers, unmatched pairs, numbers, references, footnote quotes, capitalization, repeated words, punctuation and spelling. Most of its checks run on every cell as you type, with no inventories to set up first. There is no report for a whole book yet. See Paratext checks in Aquilla.

Can I get my work out of Aquilla as USFM for Paratext?

Section titled “Can I get my work out of Aquilla as USFM for Paratext?”

Yes. Use Exporting your work to make USFM files from an Aquilla project. For a linked project, Write to Paratext already puts your edits into the Paratext files.

Does Aquilla connect to Scripture Forge or to Paratext’s online servers?

Section titled “Does Aquilla connect to Scripture Forge or to Paratext’s online servers?”

No. Aquilla works with the Paratext project files on your computer. It does not connect to Paratext’s online servers or to Scripture Forge. To use a Scripture Forge project, get it into Paratext first, or import its USFM.

Can I use a Paratext project as a source text?

Section titled “Can I use a Paratext project as a source text?”

Yes. Import the project as Source text, or link another project as a source. See Source projects.