> 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

## Resource: MachineTranslation



## Article: Introduction

## Article Link: https://dev.wix.com/docs/velo/apis/wix-multilingual-v2/machine-translation/introduction.md

## Article Content:

---
title: Introduction
---
# Introduction

<div style="background-color: #FEF1D1; padding: 18px 24px; border-radius: 6px; border: 1px solid #FDB10C; box-sizing: border-box; display: inline-block">
    <b>Developer Preview</b>
    <br/>
    <span>APIs in <a href="https://www.wix.com/velo/reference/api-overview/developer-preview">Developer Preview</a> are subject to change and are not intended for use in production.<br/><a href="https://discord.com/channels/1114269395317968906/1288424315838005259">Send us</a> your suggestions for improving this API. Your feedback is valuable to us.</span>
</div>

&nbsp;

The Machine Translation API allows you to render text from one language to another using machine translation. With this API you can provide translatable content from your code and Wix returns the translated text. 

With the Machine Translation API, you can:
- [Translate](https://dev.wix.com/docs/velo/api-reference/wix-multilingual-v2/machine-translation/machine-translate.md) text from plaintext, HTML, or rich content objects.
- [Bulk translate](https://dev.wix.com/docs/velo/api-reference/wix-multilingual-v2/machine-translation/bulk-machine-translate.md) up to 1,000 units of text.


To use the Machine Translation API, import `machineTranslation` from the `wix-multilingual.v2` module:

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


## Before you begin

It's important to note the following before starting to code: 
+ Only text translation is supported.
+ Wix does not overwrite the original content source, so make sure to store the returned `translatedContent` object separately if you want to retrieve it at a later time.
+ Translation requests must not exceed 5,000 characters or the request fails with a `TEXT_TOO_LONG` error. 
+ If the site does not have sufficient [word credits](#terminology) to translate all of the text in the request, the request fails 
  with a `NOT_ENOUGH_CREDITS` error.
+ Note that translated blogs and emails reduce a site's word credits, but are not included in the count displayed in a site's dashboard.

## Terminology
- **Machine translate**: Wix uses an external service to translate text to other languages. Alternatively, you can manually translate site content with the [Translation Manager](https://support.wix.com/en/article/wix-multilingual-using-the-translation-manager).
- **Translatable content**: Content that is able to be machine translated with this service. Learn more [about translatable and untranslatable content](https://support.wix.com/en/article/wix-multilingual-translatable-content).
- **Word credit**: Each site has a word credit balance, starting at 3,000 words. 
  Each successful translation request reduces the word credits by the number of words in `contentToTranslate`. 
  If the site does not have sufficient word credits to translate all of the text in the request, the 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).