Skip to content

Creating a project

A project is the top-level container for a translation effort. It holds your files, your team and their roles, your settings, and the quality signals Aquilla tracks (validation, health and decay, built-in checks).

From the Projects page, choose Create project. You’ll set:

  • Project name — what your team will recognise it by.
  • Source language — the language you’re translating from.
  • Target language — the language you’re translating into.

Under an advanced option you can also choose the project’s shape:

  • Self-contained (default) — owns both its source and its target text.
  • Source-only — a project that exists to be linked against as a shared source; it has no target language of its own.
  • Linked target — reads its source text from another project. See Source projects & linked targets.

Once created, the project appears on your Projects page with its file count, a last-updated time, and a health ring summarising overall progress.

A fresh project starts empty. You add the text you’re translating by:

  • importing a file — for example a USFM or plain-text source — or
  • linking a source project, so the source text flows in from a shared upstream project.

If you’re moving an existing project over from Codex instead, see Migrating from Codex.

A project is more useful with people in it. Share an invite link to bring in translators, reviewers, or viewers — each link carries the role you choose. See Inviting people and Roles & permissions.