> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Method name: bulkMachineTranslate(sourceLanguage: SupportedLanguage, options: BulkMachineTranslateOptions)

# Method package: wixMultilingualV2

# Method menu location: wixMultilingualV2 --> machineTranslation --> bulkMachineTranslate

# Method Link: https://dev.wix.com/docs/velo/apis/wix-multilingual-v2/machine-translation/bulk-machine-translate.md

# Method Description:

Translates the text of multiple units of translatable content from one supported language to another.

Each translated content item in the `results` array returns with the same `id` as the corresponding `contentToTranslate.id`, but with the text in the
content fields replaced with the translated text. Note that Wix does not overwrite the original content source,
to retrieve the translated content later, make sure to store it separately.

Only text content is translated, even if the content is `htmlContent` or `richContent`. Note that [collapsible text](https://support.wix.com/en/article/adding-and-setting-up-collapsible-text)
cannot be translated using this method.

Each unit of translatable content must not exceed 5,000 characters. If this limit is exceeded, the method returns a `TEXT_TOO_LONG` error.
For `richContent`, the 5,000-character limit applies separately to each node in `richContent.nodes`.
The total request may exceed 5,000 characters as long as no individual node surpasses this limit.
If any node exceeds 5,000 characters, then the request fails for that specific `contentToTranslate` item and the error details for that
error are returned in `itemMetadata`. Even if some translations fail due to the character limit,
the machine translation for other items will succeed if they are under the character limit.

Each site has a [word credit](/machine-translation/introduction#terminology) balance, starting at 3,000 words.
Each successful translation request reduces the word credits by the number of words included in `contentToTranslate`.
If the site does not have sufficient word credits to complete the translation, then the entire request fails
with a `NOT_ENOUGH_CREDITS` error. Additional credits can be [purchased through the Dashboard](https://support.wix.com/en/article/wix-multilingual-auto-translating-your-site?tabs=Dashboard-5#purchasing-translation-packages).

To translate a single unit of `translatableContent`, use [Machine Translate](/machine-translation/machine-translate).



# Method Code Examples:

*** Note: do not assume any prop names or enum values other than the ones in the example.

## bulkMachineTranslate example for dashboard page code

```javascript
import { machineTranslation } from 'wix-multilingual.v2';

async function bulkMachineTranslate(sourceLanguage, options) {
  try {
    const result = await machineTranslation.bulkMachineTranslate(sourceLanguage, options);
    return result;
  } catch (error) {
    console.error(error);
    // Handle the error
  }
}

```

## bulkMachineTranslate example for exporting from backend code

```javascript
import { machineTranslation } from 'wix-multilingual.v2';
import { webMethod, Permissions } from 'wix-web-module';
import { elevate } from 'wix-auth';

const elevatedBulkMachineTranslate = elevate(machineTranslation.bulkMachineTranslate);

export const bulkMachineTranslate = webMethod(
  Permissions.Anyone,
  async (sourceLanguage, options) => {
    try {
      const result = await elevatedBulkMachineTranslate(sourceLanguage, options);
      return result;
    } catch (error) {
      console.error(error);
      // Handle the error
    }
  }
);

```

---