A few terms come back on every page of this manual. This page explains them and shows where everything lives in the app.
The building blocks #
- Organization
- The workspace that holds everything: projects, teams, the glossary, members and the plan you pay for. When you create an account you get an organization of your own and become its owner.
- Project
- One product or piece of content you translate, for example “Mobile App” or “Help Center”. A project has one source language and any number of target languages.
- Branch
- A copy of the keys and translations of a project, like a Git branch. Every project has a protected
mainbranch. See Branch workflows. - Key
- One piece of text that needs translating, identified by a name such as
checkout.title. A key lives on a branch. See Key names and groups. - Source text
- The text of a key in the project’s source language. Translators work from it.
- Translation
- The text of a key in one target language. A key has one translation per language.
Translation statuses #
Every translation has a status. The editor and the review page show them like this:
| Status in the editor | Meaning |
|---|---|
| Untranslated | No translation yet, or a saved draft that has not been submitted. |
| In review | Submitted and waiting for a reviewer. |
| Changes requested | A reviewer sent it back with a comment. |
| Translated | Approved, or published directly when the project does not require review. |
| No source | The key has no source text yet, so it cannot be translated. |
Only translations that are Translated (approved) are exported by default, counted in progress percentages, and pulled by the CLI. Whether review is required is a workflow setting.
People and permissions #
Everyone belongs to an organization as owner, admin or member. Access to a project comes from a project role: translator, reviewer or manager, given directly or through a team. Owners and admins are managers of every project. See Roles and permissions.
Where to find things in the app #
The narrow bar on the left is the main navigation.
static/screenshots/app-navigation.png| Item | What it opens |
|---|---|
| Translations | The editor of your first active project. Only shown when no project is open. |
| Projects | All projects. |
| Branches | Branches of all projects. |
| Teams | Teams and their members. |
| Glossary | The terms of your organization. |
| Reports | Translation progress per project and language. |
When you open a project, the project switcher appears at the top of the bar, with these items below the others:
| Item | What it opens |
|---|---|
| Editor | The translation editor. |
| Review | The review queue. Only shown when the project requires review. |
| Translation memory | The translation memory. |
| Project glossary | The glossary, opened from this project. |
| Project team | The members and teams of this project. |
At the bottom of the bar, the cog opens Project settings (when a project is open), Organization settings and Account settings. The last icon signs you out.
Press ? anywhere in the editor or the review page to see all keyboard shortcuts. See Keyboard shortcuts.