From db696a831b290728ceed86e283e5e421e9055ebd Mon Sep 17 00:00:00 2001
From: Mykhailo Rohalskyy <mykhailo.rohalskyy@crowdin.ua>
Date: Tue, 6 Oct 2026 17:31:26 +0300
Subject: [PATCH] docs: document auto-translation word counts and refresh the
 dialog steps

- Document the Words column, the Total words row, and the label match rule
  in the auto-translate dialog
- Reorder the manual auto-translation steps to follow the dialog layout
- Align dialog, queue, task, and Editor labels with the current UI
- Rewrite the TM priority and AI QA retry sections to match how they work
- Point three Enterprise links to Enterprise pages
- Replace the Dashboard button screenshots with a location cue in the step
- Apply house style to screen positions, examples, and "allows you to"
  phrasing in the edited articles
---
 .../docs/crowdin/online-editor/overview.mdx   | 20 ++--
 .../translation-process/auto-translation.mdx  | 89 +++++++++--------
 .../enterprise/online-editor/overview.mdx     | 22 ++---
 .../translation-process/auto-translation.mdx  | 96 +++++++++----------
 4 files changed, 112 insertions(+), 115 deletions(-)

diff --git a/src/content/docs/crowdin/online-editor/overview.mdx b/src/content/docs/crowdin/online-editor/overview.mdx
index 2c4ccbce..85716c5f 100644
--- a/src/content/docs/crowdin/online-editor/overview.mdx
+++ b/src/content/docs/crowdin/online-editor/overview.mdx
@@ -326,7 +326,7 @@ You can access these options via the **Edit** menu at the top of the Editor. The
 
 ### String Menu
 
-Click <Icon name="mdi:dots-vertical" class="inline-icon" /> in the upper-right to open the menu with the following options:
+Click <Icon name="mdi:dots-vertical" class="inline-icon" /> at the upper right to open the menu with the following options:
 
 * **Remove Approval**: Remove the approval for a translation, reverting its status to unapproved. (Available for proofreaders or higher.)
 * **Remove Translation**: Clear translations for the selected strings along with the associated TM records. Duplicate translations from master strings remain unaffected.
@@ -858,14 +858,14 @@ To replace source texts, follow these steps:
 
 ### Auto-Translation in the Editor
 
-The **Auto-Translation** feature allows you to apply translations to multiple strings directly within the Editor using AI, Translation Memory (TM), or Machine Translation (MT). It gives you granular control over the process: you can use the Advanced Filter to isolate specific strings, visually review your selection, and run auto-translation specifically for that batch.
+With the **Auto-Translation** feature, you can apply translations to multiple strings directly within the Editor using AI, Translation Memory (TM), or Machine Translation (MT). It gives you granular control over the process: you can use the Advanced Filter to isolate specific strings, visually review your selection, and run auto-translation specifically for that batch.
 
 To apply auto-translation in the Editor, follow these steps:
 
 <Steps>
   1. You can open the auto-translate dialog in the Editor in two ways:
       * **Main menu** – go to **Edit** in the main menu and select **Auto-Translate**.
-      * **String menu** (available in **Side-by-Side** and **Multilingual** modes) – click <Icon name="mdi:dots-vertical" class="inline-icon" /> in the upper-right and select **Auto-Translate**.
+      * **String menu** (available in **Side-by-Side** and **Multilingual** modes) – click <Icon name="mdi:dots-vertical" class="inline-icon" /> at the upper right and select **Auto-Translate**.
   2. In the **Auto-Translate strings** dialog, configure the following parameters:
      * **Auto-Translation via** – select your preferred method (**AI**, **Translation memory**, or **Machine translation**).
      * **AI prompt** (Specific to auto-translation via AI) – select the prompt that will guide the AI model’s behavior.
@@ -875,8 +875,8 @@ To apply auto-translation in the Editor, follow these steps:
      * **Scope** – select the range of strings to apply auto-translation to:
         * **Selected strings** (Specific to **Side-by-Side** and **Multilingual** modes) – applies only to strings manually selected in the Editor.
         * **Filtered strings** – applies to all strings matching the current filter.
-        * **File** – applies to the currently opened file.
-        * **All files** – applies to all strings across all files in the project, regardless of the file currently open in the Editor.
+        * **File** (**Selected files** when several files are open, **Branch** in string-based projects) – applies to the file, files, or branch currently open in the Editor.
+        * **All files** (**All branches** in string-based projects) – applies to all strings in the project, regardless of the file or branch currently open in the Editor.
      * **Strings to process** – select **Untranslated strings**, **Translated strings (Re-translation)**, or both.
         <Aside>
           The following re-translation settings will only appear if the **Translated strings (Re-translation)** option is selected.
@@ -898,25 +898,25 @@ To apply auto-translation in the Editor, follow these steps:
           Read more about [TM Match Types](/translation-memory/#tm-match-calculation).
         </ReadMore>
   3. Expand the **Advanced settings** section to finetune the auto-translation process:
-      * **Translate from** – select the language to use as the source for auto-translation. By default, it's preselected to the project’s source language, but you can choose any other project language. This provides greater flexibility and may improve translation quality by allowing you to use a more suitable existing translation (e.g., an adapted English version instead of the original Japanese) or translate directly between related languages (e.g., Spanish to Portuguese).
+      * **Translate from** – select the language to use as the source for auto-translation. By default, it's preselected to the project's source language, but you can choose any other project language. This gives you more flexibility and can improve translation quality: you can use a more suitable existing translation (for example, an adapted English version instead of the original Japanese) or translate directly between related languages (for example, Spanish to Portuguese).
         <Aside>
           For auto-translation via AI, the project's original source text is also included as context to ensure higher accuracy.
         </Aside>
-      * **Approve added translations** (Specific to auto-translation via Translation memory) – allows you to auto-approve translations added through auto-translation. Options include:
+      * **Approve added translations** (Specific to auto-translation via Translation memory) – auto-approve translations added through auto-translation. Options include:
         * **With perfect match** – approve only those with a 101% match.
         * **With perfect match (approved previously)** – approve perfect matches only if they were already approved before.
-        * **All (skip auto-substituted translations)** – approve everything except translations improved by auto-substitution.
+        * **All (skip auto-substituted suggestions)** – approve everything except translations improved by auto-substitution.
         * **All** – approve all added translations.
   4. Click **Auto-Translate**.
 </Steps>
 
-In Side-by-side and Comfortable modes, auto-translation is applied to the single language currently selected in the Editor. In Multilingual mode, translations are applied across all selected languages, as this mode allows working with multiple languages simultaneously.
+In Side-by-side and Comfortable modes, auto-translation is applied to the single language currently selected in the Editor. In Multilingual mode, translations are applied across all selected languages, since in this mode you work with multiple languages at once.
 
 <ReadMore>
   Read more about [Multilingual mode](#multilingual-mode).
 </ReadMore>
 
-Use the **Queue** button in the bottom-left corner of the **Auto-Translate strings** dialog to track and manage all triggered auto-translation instances.
+Use the **Queue** button in the lower-left corner of the **Auto-Translate strings** dialog to track and manage all triggered auto-translation instances.
 
 <ReadMore>
   Read more about [Auto-Translation Queue](/auto-translation/#auto-translation-queue).
diff --git a/src/content/docs/crowdin/translation-process/auto-translation.mdx b/src/content/docs/crowdin/translation-process/auto-translation.mdx
index 40b7d547..911f920b 100644
--- a/src/content/docs/crowdin/translation-process/auto-translation.mdx
+++ b/src/content/docs/crowdin/translation-process/auto-translation.mdx
@@ -10,10 +10,8 @@ import { Steps, Aside, LinkCard, CardGrid } from '@astrojs/starlight/components'
 import { Icon } from 'astro-icon/components';
 import KBD from '~/components/KBD.astro';
 import ReadMore from '~/components/ReadMore.astro';
-import { Image } from 'astro:assets';
-import preTranslation from '!/crowdin/translation-process/auto_translation.png';
 
-Auto-translation helps speed up the translation process and ease the work of translators. It also allows you to save funds as part of translations can be automated. You can use and combine the following types of auto-translation:
+Auto-translation helps speed up the translation process and ease the work of translators. You also save funds, since part of the translation work is automated. You can use and combine the following types of auto-translation:
 
 - **AI Auto-Translate** - uses AI models to auto-translate the content.
 - **Machine Translation (MT) Auto-Translate** – takes translations from supported machine translation engines (MTE) and applies them to the project content. You need to configure at least one of the translation engines to enable this feature.
@@ -47,37 +45,18 @@ To apply auto-translation manually, follow these steps:
 
 <Steps>
   1. Open your project and go to the **Dashboard** tab.
-  2. Click **Auto-Translation**. <Image src={preTranslation} alt="Auto-Translation Button" />
+  2. Click **Auto-Translate** at the upper right.
   3. In the auto-translate dialog, configure the following parameters:
       * **Auto-Translation via** – select your preferred method from the drop-down list (**AI**, **Machine Translation**, or **Translation Memory**).
       * **AI Prompts** (Specific to auto-translation via AI) – select the prompt that will guide the AI model's behavior. Click the **Manage prompts** link to edit or add new prompts, or click <Icon name="mdi:eye" class="inline-icon" /> to preview and edit the currently selected prompt.
-      * **Custom instruction (Optional)** (Specific to auto-translation via AI) – add any additional context or specific instructions to guide the AI (e.g., tone, domain). Your input will be included alongside the selected prompt.
+      * **Custom instruction (Optional)** (Specific to auto-translation via AI) – add any additional context or specific instructions to guide the AI (for example, tone or domain). Your input will be included alongside the selected prompt.
       * **Translation engine** (Specific to auto-translation via Machine Translation) – select the machine translation engine to use.
       * **Translation Memories** (Specific to auto-translation via Translation Memory) – shows the translation memories from which the existing translations will be applied to your project content. Click **Manage** to configure the [Translation Memories](/project-settings/translation-memories/) settings.
       * **Minimum match ratio** (Specific to auto-translation via Translation Memory) – select either **100%** or **Perfect** as the minimum similarity required for TM matches.
         <ReadMore>
           Read more about [TM Match Types](/translation-memory/#tm-match-calculation).
         </ReadMore>
-      * **Target languages** – select the languages to auto-translate into. Use **Search languages** to quickly find the desired language.
-      * **Notify me when Auto-Translation finishes** – get notified when the auto-translation completes, fails, or is canceled. The notification arrives through the channels selected for the **Auto-Translation** event in your [notification settings](/account-settings/#notifications).
-  4. Expand the **Advanced settings** section to finetune the auto-translation process:
-      * **Translate from** – select the language to use as the source for auto-translation. By default, it's preselected to the project’s source language, but you can choose any other project language. This provides greater flexibility and may improve translation quality by allowing you to use a more suitable existing translation (e.g., an adapted English version instead of the original Japanese) or translate directly between related languages (e.g., Spanish to Portuguese).
-        <Aside>
-          For auto-translation via AI, the project's original source text is also included as context to ensure higher accuracy.
-        </Aside>
-      * **Approve added translations** (Specific to auto-translation via Translation Memory) – allows you to auto-approve translations added through auto-translation. Options include:
-        * **With perfect match** – approve only those with a 101% match.
-        * **With perfect match (approved previously)** – approve perfect matches only if they were already approved before.
-        * **All (skip auto-substituted translations)** – approve everything except translations improved by auto-substitution.
-        * **All** – approve all added translations.
-      * **Filter by labels / Exclude labels** – include or exclude specific strings based on their assigned labels.
-        <ReadMore>
-          Read more about [Labels](/string-management/#labels).
-        </ReadMore>
-        <Aside type="tip" title="Get more control">
-          Filter strings in the Editor, review the selection, and run [Auto-Translation](/online-editor/#auto-translation-in-the-editor) from there.
-        </Aside>
-  5. In the **Scope** section, define which strings should be auto-translated:
+  4. In the **Scope** section, define which strings should be auto-translated:
       * **Strings to process** – select **Untranslated strings**, **Translated strings (Re-translation)**, or both.
       <Aside>
         The following re-translation settings will only appear if the **Translated strings (Re-translation)** option is selected.
@@ -99,11 +78,35 @@ To apply auto-translation manually, follow these steps:
           * **Replace all existing translations** disables the **Allow duplicate translations** and **Reset approval status so proofreaders can re-review** options.
           * **Skip approved strings** disables the **Reset approval status so proofreaders can re-review** option.
         </Aside>
-  6. In the **Files** section (Specific to [file-based projects](/creating-project/#file-based-project)) or **Branches** section (Specific to [string-based projects](/creating-project/#string-based-project)), select the content you want to auto-translate. Use the search bar to quickly locate specific items.
+  5. *(Optional)* Select **Notify me when Auto-Translation finishes** to get notified when the auto-translation completes, fails, or is canceled. The notification arrives through the channels selected for the **Auto-Translation** event in your [notification settings](/account-settings/#notifications).
+  6. Expand the **Advanced settings** section to finetune the auto-translation process:
+      * **Translate from** – select the language to use as the source for auto-translation. By default, it's preselected to the project's source language, but you can choose any other project language. This gives you more flexibility and can improve translation quality: you can use a more suitable existing translation (for example, an adapted English version instead of the original Japanese) or translate directly between related languages (for example, Spanish to Portuguese).
+        <Aside>
+          For auto-translation via AI, the project's original source text is also included as context to ensure higher accuracy.
+        </Aside>
+      * **Approve added translations** (Specific to auto-translation via Translation Memory) – auto-approve translations added through auto-translation. Options include:
+        * **With perfect match** – approve only those with a 101% match.
+        * **With perfect match (approved previously)** – approve perfect matches only if they were already approved before.
+        * **All (skip auto-substituted suggestions)** – approve everything except translations improved by auto-substitution.
+        * **All** – approve all added translations.
+      * **Filter by labels** – select one or more labels to include only strings with the specified labels. Then, select the match rule:
+        * **All selected labels** – includes only strings that have all selected labels (AND logic).
+        * **Any selected label** – includes strings that have at least one of the selected labels (OR logic).
+      * **Exclude labels** – select one or more labels to exclude strings with the specified labels. Then, select the match rule:
+        * **All selected labels** – excludes only strings that have all selected labels (AND logic).
+        * **Any selected label** – excludes strings that have at least one of the selected labels (OR logic).
+        <ReadMore>
+          Read more about [Labels](/string-management/#labels).
+        </ReadMore>
+        <Aside type="tip" title="Get more control">
+          Filter strings in the Editor, review the selection, and run [Auto-Translation](/online-editor/#auto-translation-in-the-editor) from there.
+        </Aside>
+  7. In the **Files** section (Specific to [file-based projects](/creating-project/#file-based-project)) or **Branches** section (Specific to [string-based projects](/creating-project/#string-based-project)), select the content you want to auto-translate. Use the search bar to quickly locate specific items.
       <Aside type="caution">
-        Auto-Translation is not allowed for protected branches. If a protected branch is selected, the **Auto-Translate** button will be unavailable until a different branch is chosen.
+        Auto-Translation is not allowed for protected branches, so they appear unavailable in this section.
       </Aside>
-  7. Click **Auto-Translate**.
+  8. In the **Target languages** section, select the languages to auto-translate into. The **Words** column shows how many words are in scope for each language, based on the files, labels, and scope you selected. The **Total words** row adds up the words of the selected languages. The numbers update as you change these settings, so you can check the size of the auto-translation before you start it.
+  9. Click **Auto-Translate**.
 </Steps>
 
 <Aside>
@@ -143,7 +146,7 @@ To auto-translate the strings included in a translation task, follow these steps
 
 <Steps>
   1. Open your project and go to the **Tasks** tab.
-  2. Click on the name of the needed task either in the **Board** or **All tasks** section.
+  2. Click on the name of the needed task either in the **Board** or **All Tasks** section.
   3. In the task details view, click <Icon name="mdi:dots-horizontal" class="inline-icon" /> in the upper-right corner and select **Auto-Translate**.
   4. In the auto-translate dialog, the task defines both the strings to process and the target language. Configure the rest of the parameters as described in the [Manual Auto-translation](#manual-auto-translation) section.
   5. Click **Auto-Translate**.
@@ -155,26 +158,26 @@ To auto-translate the strings included in a translation task, follow these steps
 
 ### Auto-Translation Queue
 
-The Auto-Translation queue allows you to trigger multiple manual auto-translations via TM, MT, or AI, each with different settings. After initiating an auto-translation, each instance enters a queue with a status of **Pending**.
+With the Auto-Translation queue, you can trigger multiple manual auto-translations via TM, MT, or AI, each with different settings. After initiating an auto-translation, each instance enters a queue with a status of **Pending**.
 
-Upon triggering a manual auto-translation, you will receive a notification indicating that the process has been added to the queue. To review all auto-translations currently in the queue, navigate to **Tools > Auto-Translation queue** in your project. Alternatively, click **View Queue** in the bottom-left corner of the auto-translate dialog to be redirected directly to this page.
+Upon triggering a manual auto-translation, you will receive a notification indicating that the process has been added to the queue. To review all auto-translations currently in the queue, navigate to **Tools > Auto-Translation queue** in your project. Alternatively, click **View Queue** in the lower-left corner of the auto-translate dialog to be redirected directly to this page.
 
 Each entry in the Auto-Translation queue table includes the following details:
 
 - **Created at:** Displays the date and time when the auto-translation was initiated.
-- **Type:** Shows the method and specific engine or prompt used (e.g., AI, MT engine name). For auto-translations initiated from a task, the task number and title are shown as well.
+- **Type:** Shows the method and specific engine or prompt used (for example, AI or the MT engine name). For auto-translations initiated from a task, the task number and title are shown as well.
 - **Priority:** Indicates the execution priority of the task (low, normal, high). When the active auto-translation finishes, the system selects the pending job with the highest priority next. If multiple jobs share the same priority level, they are executed in the order they were created.
 - **Status:** Pending, In progress, Completed, Failed, or Canceled. If a job fails, the system will automatically proceed to the next pending job in the queue without blocking it.
 - **Started at:** The date and time the process began.
 - **Finished at:** The date and time the process was completed.
 
-You can use the **Filters** button to sort the queue by specific statuses, priorities, or types.
+You can use the **Filters** button to filter the queue by specific statuses, priorities, or types.
 
-You can also manage pending jobs individually or in bulk. Select the checkboxes next to the relevant pending entries to change their priority or cancel them simultaneously using the **Cancel Auto-Translation Jobs** and priority buttons in the top toolbar.
+You can also manage pending jobs individually or in bulk. Select the checkboxes next to the relevant pending entries to change their priority or cancel them simultaneously using the **Priority** and **Cancel** buttons in the top toolbar.
 
-For completed auto-translations, you can view a report detailing the results, including target languages, a list of processed files, the number of translations added, and the number of translations skipped with a breakdown by category (e.g., missing in TM, QA issue).
+For completed auto-translations, you can view a report detailing the results, including target languages, a list of processed files, the number of translations added, and the number of translations skipped with a breakdown by category (for example, missing in TM or QA issue).
 
-To repeat an auto-translation, click <Icon name="mdi:dots-horizontal" class="inline-icon" /> on the relevant entry and select **Retry**. This opens the auto-translation dialog with all the original settings pre-selected, allowing you to quickly launch the process again without manual reconfiguration. This is especially helpful if an auto-translation attempt fails or if you need to apply the same configuration again.
+To repeat an auto-translation, click <Icon name="mdi:dots-horizontal" class="inline-icon" /> on the relevant entry and select **Retry**. This opens the auto-translation dialog with all the original settings pre-selected, so you can quickly launch the process again without manual reconfiguration. This is especially helpful if an auto-translation attempt fails or if you need to apply the same configuration again.
 
 <Aside type="caution" title="Limitations">
   * Only one auto-translation process can run at a time per project. Any additional jobs are queued as **Pending**.
@@ -191,16 +194,12 @@ You can automate the Auto-Translation in the project **Settings > Auto-Translate
 
 ## Handling QA Issues During Auto-translation via AI
 
-If the AI provider returns translations with QA issues during auto-translation, Crowdin will collect the strings to which these faulty translations were applied and automatically reinitiate the auto-translation. The affected strings will be sent back to the AI provider along with details of the detected QA issues to ensure that the translations are corrected and meet quality standards.
+If **Auto-retry on QA issues** is enabled for the selected [AI prompt](/crowdin-ai/#configuring-ai-prompts), Crowdin runs QA checks on the translations the AI returns. Strings whose translations have QA issues are sent back to the AI provider once more, along with the faulty translation and the detected QA issues, so the AI can correct them.
 
 ## Translation Memory Priority During Auto-translation via TM
 
-When using auto-translation via TM, Crowdin applies translations from translation memories based on a specific priority order. This priority ensures that translations come from the most relevant source, optimizing translation consistency and quality.
-
-The order of priority is as follows:
+When using auto-translation via TM, Crowdin takes into account the TM priorities and penalties set in the project settings. A penalty lowers the match ratio of a TM suggestion (for example, **TM priority less than** penalizes suggestions from TMs with a priority lower than a specified value), so a penalized match can fall below the selected **Minimum match ratio** and isn't applied.
 
-1. **Default TM**: Matches are first searched for in the project’s default TM.
-2. **Assigned TMs**: If no match is found in the default TM, the system continues searching through any TMs assigned specifically to the project.
-3. **Shared TMs**: If no match is found in the default or assigned TMs, translations are retrieved from shared TMs available to the project.
-
-This sequence allows Crowdin to apply translations from the most relevant TM source first, ensuring that high-quality matches are prioritized when multiple TMs are available.
+<ReadMore>
+  Read more about [Prioritizing TM](/project-settings/translation-memories/#prioritizing-tm) and [Penalties](/project-settings/translation-memories/#penalties).
+</ReadMore>
diff --git a/src/content/docs/enterprise/online-editor/overview.mdx b/src/content/docs/enterprise/online-editor/overview.mdx
index cb0b6e1c..877656ef 100644
--- a/src/content/docs/enterprise/online-editor/overview.mdx
+++ b/src/content/docs/enterprise/online-editor/overview.mdx
@@ -159,7 +159,7 @@ To remove approvals one by one, follow these steps:
   3. Click **Remove** next to the approval you want to remove.
 </Steps>
 
-To remove all approvals at once, click <Icon name="mdi:dots-vertical" class="inline-icon" /> in the upper-right and select **Remove All Approvals**. To remove only your own approvals, select **Remove My Approvals** instead.
+To remove all approvals at once, click <Icon name="mdi:dots-vertical" class="inline-icon" /> at the upper right and select **Remove All Approvals**. To remove only your own approvals, select **Remove My Approvals** instead.
 
 ##### Translation Priority
 
@@ -371,7 +371,7 @@ You can access these options via the **Edit** menu at the top of the Editor. The
 
 ### String Menu
 
-Click <Icon name="mdi:dots-vertical" class="inline-icon" /> in the upper-right to open the menu with the following options:
+Click <Icon name="mdi:dots-vertical" class="inline-icon" /> at the upper right to open the menu with the following options:
 
 * **Remove My Approvals** / **Remove All Approvals**: Remove the approvals for a translation, reverting its status to unapproved. (Available for proofreaders or higher.)
 * **Remove Translation**: Clear translations for the selected strings along with the associated TM records. Duplicate translations from master strings remain unaffected.
@@ -928,14 +928,14 @@ To replace source texts, follow these steps:
 
 ### Auto-Translation in the Editor
 
-The **Auto-Translation** feature allows you to apply translations to multiple strings directly within the Editor using AI, Translation Memory (TM), or Machine Translation (MT). It gives you granular control over the process: you can use the Advanced Filter to isolate specific strings, visually review your selection, and run auto-translation specifically for that batch.
+With the **Auto-Translation** feature, you can apply translations to multiple strings directly within the Editor using AI, Translation Memory (TM), or Machine Translation (MT). It gives you granular control over the process: you can use the Advanced Filter to isolate specific strings, visually review your selection, and run auto-translation specifically for that batch.
 
 To apply auto-translation in the Editor, follow these steps:
 
 <Steps>
   1. You can open the auto-translate dialog in the Editor in two ways:
       * **Main menu** – go to **Edit** in the main menu and select **Auto-Translate**.
-      * **String menu** (available in **Side-by-Side** and **Multilingual** modes) – click <Icon name="mdi:dots-vertical" class="inline-icon" /> in the upper-right and select **Auto-Translate**.
+      * **String menu** (available in **Side-by-Side** and **Multilingual** modes) – click <Icon name="mdi:dots-vertical" class="inline-icon" /> at the upper right and select **Auto-Translate**.
   2. In the **Auto-Translate strings** dialog, configure the following parameters:
      * **Auto-Translation via** – select your preferred method (**AI**, **Translation memory**, or **Machine translation**).
      * **AI prompt** (Specific to auto-translation via AI) – select the prompt that will guide the AI model’s behavior.
@@ -945,8 +945,8 @@ To apply auto-translation in the Editor, follow these steps:
      * **Scope** – select the range of strings to apply auto-translation to:
         * **Selected strings** (Specific to **Side-by-Side** and **Multilingual** modes) – applies only to strings manually selected in the Editor.
         * **Filtered strings** – applies to all strings matching the current filter.
-        * **File** – applies to the currently opened file.
-        * **All files** – applies to all strings across all files in the project, regardless of the file currently open in the Editor.
+        * **File** (**Selected files** when several files are open, **Branch** in string-based projects) – applies to the file, files, or branch currently open in the Editor.
+        * **All files** (**All branches** in string-based projects) – applies to all strings in the project, regardless of the file or branch currently open in the Editor.
      * **Strings to process** – select **Untranslated strings**, **Translated strings (Re-translation)**, or both.
         <Aside>
           The following re-translation settings will only appear if the **Translated strings (Re-translation)** option is selected.
@@ -968,25 +968,25 @@ To apply auto-translation in the Editor, follow these steps:
           Read more about [TM Match Types](/enterprise/translation-memory/#tm-match-calculation).
         </ReadMore>
   3. Expand the **Advanced settings** section to finetune the auto-translation process:
-      * **Translate from** – select the language to use as the source for auto-translation. By default, it's preselected to the source language of the workflow step you have open (the project source language in projects without a workflow), but you can choose any other project language. This provides greater flexibility and may improve translation quality by allowing you to use a more suitable existing translation (e.g., an adapted English version instead of the original Japanese) or translate directly between related languages (e.g., Spanish to Portuguese).
+      * **Translate from** – select the language to use as the source for auto-translation. By default, it's preselected to the source language of the workflow step you have open (the project source language in projects without a workflow), but you can choose any other project language. This gives you more flexibility and can improve translation quality: you can use a more suitable existing translation (for example, an adapted English version instead of the original Japanese) or translate directly between related languages (for example, Spanish to Portuguese).
         <Aside>
           For auto-translation via AI, the project's original source text is also included as context to ensure higher accuracy.
         </Aside>
-      * **Approve added translations** (Specific to auto-translation via Translation memory) – allows you to auto-approve translations added through auto-translation. Options include:
+      * **Approve added translations** (Specific to auto-translation via Translation memory) – auto-approve translations added through auto-translation. Options include:
         * **With perfect match** – approve only those with a 101% match.
         * **With perfect match (approved previously)** – approve perfect matches only if they were already approved before.
-        * **All (skip auto-substituted translations)** – approve everything except translations improved by auto-substitution.
+        * **All (skip auto-substituted suggestions)** – approve everything except translations improved by auto-substitution.
         * **All** – approve all added translations.
   4. Click **Auto-Translate**.
 </Steps>
 
-In Side-by-side and Comfortable modes, auto-translation is applied to the single language currently selected in the Editor. In Multilingual mode, translations are applied across all selected languages, as this mode allows working with multiple languages simultaneously.
+In Side-by-side and Comfortable modes, auto-translation is applied to the single language currently selected in the Editor. In Multilingual mode, translations are applied across all selected languages, since in this mode you work with multiple languages at once.
 
 <ReadMore>
   Read more about [Multilingual mode](#multilingual-mode).
 </ReadMore>
 
-Use the **Queue** button in the bottom-left corner of the **Auto-Translate strings** dialog to track and manage all triggered auto-translation instances.
+Use the **Queue** button in the lower-left corner of the **Auto-Translate strings** dialog to track and manage all triggered auto-translation instances.
 
 <ReadMore>
   Read more about [Auto-Translation Queue](/enterprise/auto-translation/#auto-translation-queue).
diff --git a/src/content/docs/enterprise/translation-process/auto-translation.mdx b/src/content/docs/enterprise/translation-process/auto-translation.mdx
index 71979131..3ecf2b3e 100644
--- a/src/content/docs/enterprise/translation-process/auto-translation.mdx
+++ b/src/content/docs/enterprise/translation-process/auto-translation.mdx
@@ -11,10 +11,8 @@ import { Icon } from 'astro-icon/components';
 import KBD from '~/components/KBD.astro';
 import QuestionAnswer from '~/components/QuestionAnswer.astro';
 import ReadMore from '~/components/ReadMore.astro';
-import { Image } from 'astro:assets';
-import preTranslate from '!/enterprise/translation-process/auto_translate.png';
 
-Auto-translation helps speed up the translation process and ease the work of translators. It also allows you to save funds as part of translations can be automated. You can use and combine the following types of auto-translation:
+Auto-translation helps speed up the translation process and ease the work of translators. You also save funds, since part of the translation work is automated. You can use and combine the following types of auto-translation:
 
 - **AI Auto-Translate** - uses AI models to auto-translate the content.
 - **Machine Translation (MT) Auto-Translate** – takes translations from supported machine translation engines (MTE) and applies them to the project content. You need to configure at least one of the translation engines to enable this feature.
@@ -48,37 +46,17 @@ To apply auto-translation manually, follow these steps:
 
 <Steps>
   1. Open your project and select **Dashboard** on the left sidebar.
-  2. Click **Auto-Translate**. <Image src={preTranslate} alt="Auto-Translate Button" />
+  2. Click **Auto-Translate** at the upper right.
   3. In the auto-translate dialog, configure the following parameters:
       * **Auto-Translation via** – select your preferred method from the drop-down list (**AI**, **Machine Translation**, or **Translation Memory**).
       * **Select AI prompt** (Specific to auto-translation via AI) – select the prompt that will guide the AI model's behavior. Click the **Manage prompts** link to edit or add new prompts, or click <Icon name="mdi:eye" class="inline-icon" /> to preview and edit the currently selected prompt.
-      * **Custom instruction (optional)** (Specific to auto-translation via AI) – add any additional context or specific instructions to guide the AI (e.g., tone, domain). Your input will be included alongside the selected prompt.
-      * **Translation engine** (Specific to auto-translation via Machine Translation) – select the machine translation engine to use.
-      * **Translation Memories** (Specific to auto-translation via Translation Memory) – shows the translation memories from which the existing translations will be applied to your project content. Click **Manage** to configure the [Translation Memories](/project-settings/translation-memories/) settings.
-      * **Minimum match ratio** (Specific to auto-translation via Translation Memory) – set a similarity threshold between **40% and 100%** or select **Perfect** as the minimum similarity required for TM matches.
+      * **Custom instruction (optional)** (Specific to auto-translation via AI) – add any additional context or specific instructions to guide the AI (for example, tone or domain). Your input will be included alongside the selected prompt.
+      * **Select MT Engine** (Specific to auto-translation via Machine Translation) – select the machine translation engine to use.
+      * **Minimum match ratio** (Specific to auto-translation via Translation Memory) – set a similarity threshold between 40% and 100% or select **Perfect** as the minimum similarity required for TM matches. To configure the project's [Translation Memories](/enterprise/project-settings/translation-memories/) settings, click **Manage**.
         <ReadMore>
           Read more about [TM Match Types](/enterprise/translation-memory/#tm-match-calculation).
         </ReadMore>
-      * **Select languages** – select the languages to auto-translate into. Use **Search languages** to quickly find the desired language.
-      * **Notify me when Auto-Translation finishes** – get notified when the auto-translation completes, fails, or is canceled. The notification arrives through the channels selected for the **Auto-Translation** event in your [notification settings](/enterprise/account-settings/#notifications).
-  4. Expand the **Advanced settings** section to finetune the auto-translation process:
-      * **Translate from** – select the language to use as the source for auto-translation. By default, it's preselected to the project’s source language, but you can choose any other project language. This provides greater flexibility and may improve translation quality by allowing you to use a more suitable existing translation (e.g., an adapted English version instead of the original Japanese) or translate directly between related languages (e.g., Spanish to Portuguese).
-        <Aside>
-          For auto-translation via AI, the project's original source text is also included as context to ensure higher accuracy.
-        </Aside>
-      * **Approve added translations** (Specific to auto-translation via Translation Memory) – allows you to auto-approve translations added through auto-translation. Options include:
-        * **With perfect match** – approve only those with a 101% match.
-        * **With perfect match (approved previously)** – approve perfect matches only if they were already approved before.
-        * **All (skip auto-substituted translations)** – approve everything except translations improved by auto-substitution.
-        * **All** – approve all added translations.
-      * **Filter by labels / Exclude labels** – include or exclude specific strings based on their assigned labels.
-        <ReadMore>
-          Read more about [Labels](/string-management/#labels).
-        </ReadMore>
-        <Aside type="tip" title="Get more control">
-          Filter strings in the Editor, review the selection, and run [Auto-Translation](/online-editor/#auto-translation-in-the-editor) from there.
-        </Aside>
-  5. In the **Scope** section, define which strings should be auto-translated:
+  4. In the **Scope** section, define which strings should be auto-translated:
       * **Strings to process** – select **Untranslated strings**, **Translated strings (Re-translation)**, or both.
       <Aside>
         The following re-translation settings will only appear if the **Translated strings (Re-translation)** option is selected.
@@ -100,11 +78,35 @@ To apply auto-translation manually, follow these steps:
           * **Replace all existing translations** disables the **Allow duplicate translations** and **Reset approval status so proofreaders can re-review** options.
           * **Skip approved strings** disables the **Reset approval status so proofreaders can re-review** option.
         </Aside>
-  6. In the **Files** section (Specific to [file-based projects](/enterprise/creating-project/#file-based-project)) or **Branches** section (Specific to [string-based projects](/enterprise/creating-project/#string-based-project)), select the content you want to auto-translate. Use the search bar to quickly locate specific items.
+  5. *(Optional)* Select **Notify me when Auto-Translation finishes** to get notified when the auto-translation completes, fails, or is canceled. The notification arrives through the channels selected for the **Auto-Translation** event in your [notification settings](/enterprise/account-settings/#notifications).
+  6. Expand the **Advanced settings** section to finetune the auto-translation process:
+      * **Translate from** – select the language to use as the source for auto-translation. By default, it's preselected to the project's source language, but you can choose any other project language. This gives you more flexibility and can improve translation quality: you can use a more suitable existing translation (for example, an adapted English version instead of the original Japanese) or translate directly between related languages (for example, Spanish to Portuguese).
+        <Aside>
+          For auto-translation via AI, the project's original source text is also included as context to ensure higher accuracy.
+        </Aside>
+      * **Approve added translations** (Specific to auto-translation via Translation Memory) – auto-approve translations added through auto-translation. Options include:
+        * **With perfect match** – approve only those with a 101% match.
+        * **With perfect match (approved previously)** – approve perfect matches only if they were already approved before.
+        * **All (skip auto-substituted translations)** – approve everything except translations improved by auto-substitution.
+        * **All** – approve all added translations.
+      * **Filter by labels (optional)** – select one or more labels to include only strings with the specified labels. Then, select the match rule:
+        * **All selected labels** – includes only strings that have all selected labels (AND logic).
+        * **Any selected label** – includes strings that have at least one of the selected labels (OR logic).
+      * **Exclude labels (optional)** – select one or more labels to exclude strings with the specified labels. Then, select the match rule:
+        * **All selected labels** – excludes only strings that have all selected labels (AND logic).
+        * **Any selected label** – excludes strings that have at least one of the selected labels (OR logic).
+        <ReadMore>
+          Read more about [Labels](/enterprise/string-management/#labels).
+        </ReadMore>
+        <Aside type="tip" title="Get more control">
+          Filter strings in the Editor, review the selection, and run [Auto-Translation](/enterprise/online-editor/#auto-translation-in-the-editor) from there.
+        </Aside>
+  7. Select the content you want to auto-translate: files in [file-based projects](/enterprise/creating-project/#file-based-project) or branches in [string-based projects](/enterprise/creating-project/#string-based-project). Use the search bar to quickly locate specific items.
       <Aside type="caution">
         Auto-Translation is not allowed for protected branches. If a protected branch is selected, the **Auto-Translate** button will be unavailable until a different branch is chosen.
       </Aside>
-  7. Click **Auto-Translate**.
+  8. In the **Languages** section, select the languages to auto-translate into. The **Words** column shows how many words are in scope for each language, based on the files, labels, and scope you selected. The **Total words** row adds up the words of the selected languages. The numbers update as you change these settings, so you can check the size of the auto-translation before you start it.
+  9. Click **Auto-Translate**.
 </Steps>
 
 <Aside>
@@ -156,26 +158,26 @@ To auto-translate the strings included in a translation task, follow these steps
 
 ### Auto-Translation Queue
 
-The Auto-Translation queue allows you to trigger multiple manual auto-translations via TM, MT, or AI, each with different settings. After initiating an auto-translation, each instance enters a queue with a status of **Pending**.
+With the Auto-Translation queue, you can trigger multiple manual auto-translations via TM, MT, or AI, each with different settings. After initiating an auto-translation, each instance enters a queue with a status of **Pending**.
 
-Upon triggering a manual auto-translation, you will receive a notification indicating that the process has been added to the queue. To review all auto-translations currently in the queue, navigate to **Tools > Auto-Translation queue** in your project. Alternatively, click **View Queue** in the upper-right corner of the auto-translate dialog to be redirected directly to this page.
+Upon triggering a manual auto-translation, you will receive a notification indicating that the process has been added to the queue. To review all auto-translations currently in the queue, navigate to **Tools > Auto-Translation queue** in your project. Alternatively, click **View queue** in the upper-right corner of the auto-translate dialog to be redirected directly to this page.
 
 Each entry in the Auto-Translation queue table includes the following details:
 
 - **Created at:** Displays the date and time when the auto-translation was initiated.
-- **Type:** Shows the method and specific engine or prompt used (e.g., AI, MT engine name). For auto-translations initiated from a task, the task number and title are shown as well.
-- **Priority:** Indicates the execution priority of the task (low, normal, high). When the active auto-translation finishes, the system selects the pending job with the highest priority next. If multiple jobs share the same priority level, they are executed in the order they were created.
+- **Type:** Shows the method and specific engine or prompt used (for example, AI or the MT engine name). For auto-translations initiated from a task, the task number and title are shown as well.
+- **Priority:** Indicates the execution priority of the task (low, medium, high). When the active auto-translation finishes, the system selects the pending job with the highest priority next. If multiple jobs share the same priority level, they are executed in the order they were created.
 - **Status:** Pending, In progress, Completed, Failed, or Canceled. If a job fails, the system will automatically proceed to the next pending job in the queue without blocking it.
 - **Started at:** The date and time the process began.
 - **Finished at:** The date and time the process was completed.
 
-You can use the **Filters** button to sort the queue by specific statuses, priorities, or types.
+You can use the **Filter** button to filter the queue by specific statuses, priorities, or types.
 
-You can also manage pending jobs individually or in bulk. Select the checkboxes next to the relevant pending entries to change their priority or cancel them simultaneously using the **Cancel Auto-Translation Jobs** and priority buttons in the top toolbar.
+You can also manage pending jobs individually or in bulk. Select the checkboxes next to the relevant pending entries to change their priority or cancel them simultaneously using the **Priority** and **Cancel** buttons in the top toolbar.
 
-For completed auto-translations, you can view a report detailing the results, including target languages, a list of processed files, the number of translations added, and the number of translations skipped with a breakdown by category (e.g., missing in TM, QA issue).
+For completed auto-translations, you can view a report detailing the results, including target languages, a list of processed files, the number of translations added, and the number of translations skipped with a breakdown by category (for example, missing in TM or QA issue).
 
-To repeat an auto-translation, click <Icon name="mdi:dots-vertical" class="inline-icon" /> on the relevant entry and select **Retry**. This opens the auto-translation dialog with all the original settings pre-selected, allowing you to quickly launch the process again without manual reconfiguration. This is especially helpful if an auto-translation attempt fails or if you need to apply the same configuration again.
+To repeat an auto-translation, click <Icon name="mdi:dots-vertical" class="inline-icon" /> on the relevant entry and select **Retry**. This opens the auto-translation dialog with all the original settings pre-selected, so you can quickly launch the process again without manual reconfiguration. This is especially helpful if an auto-translation attempt fails or if you need to apply the same configuration again.
 
 <Aside type="caution" title="Limitations">
   * Only one auto-translation process can run at a time per project. Any additional jobs are queued as **Pending**.
@@ -192,28 +194,24 @@ When working with [projects with a workflow](/enterprise/creating-project/#proje
 
 ## Handling QA Issues During Auto-translation via AI
 
-If the AI provider returns translations with QA issues during auto-translation, Crowdin Enterprise will collect the strings to which these faulty translations were applied and automatically reinitiate the auto-translation. The affected strings will be sent back to the AI provider along with details of the detected QA issues to ensure that the translations are corrected and meet quality standards.
+If **Auto-retry on QA issues** is enabled for the selected [AI prompt](/enterprise/crowdin-ai/#configuring-ai-prompts), Crowdin Enterprise runs QA checks on the translations the AI returns. Strings whose translations have QA issues are sent back to the AI provider once more, along with the faulty translation and the detected QA issues, so the AI can correct them.
 
 ## Translation Memory Priority During Auto-translation via TM
 
-When using auto-translation via TM, Crowdin Enterprise applies translations from translation memories based on a specific priority order. This priority ensures that translations come from the most relevant source, optimizing translation consistency and quality.
-
-The order of priority is as follows:
+When using auto-translation via TM, Crowdin Enterprise takes into account the TM priorities and penalties set in the project settings. A penalty lowers the match ratio of a TM suggestion (for example, **TM priority less than** penalizes suggestions from TMs with a priority lower than a specified value), so a penalized match can fall below the selected **Minimum match ratio** and isn't applied.
 
-1. **Default TM**: Matches are first searched for in the project’s default TM.
-2. **Assigned TMs**: If no match is found in the default TM, the system continues searching through any TMs assigned specifically to the project.
-3. **Shared TMs**: If no match is found in the default or assigned TMs, translations are retrieved from shared TMs available to the project.
-
-This sequence allows Crowdin Enterprise to apply translations from the most relevant TM source first, ensuring that high-quality matches are prioritized when multiple TMs are available.
+<ReadMore>
+  Read more about [Prioritizing TM](/enterprise/project-settings/translation-memories/#prioritizing-tm) and [Penalties](/enterprise/project-settings/translation-memories/#penalties).
+</ReadMore>
 
 ## Q&A
 
-<QuestionAnswer title="My project workflow includes a Switch Source Language step (e.g., switching from Tamil to English) followed by the TM Auto-Translation step. Which source language will be used for automatic and manual auto-translation?">
+<QuestionAnswer title="My project workflow includes a Switch Source Language step (for example, switching from Tamil to English) followed by the TM Auto-Translation step. Which source language will be used for automatic and manual auto-translation?">
   When a **Switch Source Language** step is included in the workflow, the behavior of auto-translation depends on how it's triggered.
 
   - **Manual auto-translation** started from the project (the **Dashboard**, a language page, or **Sources > Files**) will use the initial project source language (Tamil in this case).
   - **Manual auto-translation** started within a workflow step (from the Editor opened on that step, or from a task that belongs to it) will use that step's source language (English for a step that follows the switch), unless you select a different one in **Translate from**.
-  - **Workflow-based auto-translation** (e.g., an automatic TM Auto-Translation after the source language switch) will use the switched source language (English).
+  - **Workflow-based auto-translation** (for example, an automatic TM Auto-Translation after the source language switch) will use the switched source language (English).
 
   This applies to TM, MT, and AI auto-translations.
 </QuestionAnswer>