# General Translation Platform: DataFormat
URL: https://generaltranslation.com/en-GB/docs/platform/core/reference/types/data-format.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Supported translation data format values. API reference for DataFormat type.

`DataFormat` specifies the format of translatable content. It appears as the `dataFormat` field of [`EntryMetadata`](/docs/platform/core/reference/types/entry-metadata) and determines how the translation system processes an entry.

## Overview [#overview]

`DataFormat` is a string union of the four supported content formats. Setting it explicitly ensures content is parsed and translated correctly; auto-detection is possible but explicit specification is recommended.

```typescript
type DataFormat = 'JSX' | 'ICU' | 'I18NEXT' | 'STRING';
```

## Values [#values]

| Value       | Description                 | Content type                                                      | Use case                                             |
| ----------- | --------------------------- | ----------------------------------------------------------------- | ---------------------------------------------------- |
| `'JSX'`     | JSX/React component format. | [`JsxChildren`](/docs/platform/core/reference/types/jsx-children) | Rich UI components with elements and variables.      |
| `'ICU'`     | ICU MessageFormat.          | `IcuMessage` (string)                                             | Complex formatting with plurals, dates, and numbers. |
| `'I18NEXT'` | i18next message format.     | `I18nextMessage` (string)                                         | Simple interpolation and existing i18next projects.  |
| `'STRING'`  | Plain string format.        | `string`                                                          | Simple text content.                                 |

### Format characteristics

| Format    | Variables               | Pluralisation       | HTML elements       | Date/number formatting |
| --------- | ----------------------- | ------------------- | ------------------- | ---------------------- |
| `JSX`     | ✅ Rich variables        | ✅ Through branching | ✅ Full HTML support | ✅ Via variables        |
| `ICU`     | ✅ `{variable}` syntax   | ✅ Built-in plurals  | ❌ Text only         | ✅ Built-in formatters  |
| `I18NEXT` | ✅ `{{variable}}` syntax | ✅ Via count         | ❌ Text only         | ✅ Via formatters       |
| `STRING`  | ❌                       | ❌                   | ❌                   | ❌                      |

## Example [#example]

```typescript
const icuEntry: TranslateManyEntry = {
  source: 'Hello {name}',
  metadata: { dataFormat: 'ICU' }
};

const plainEntry: TranslateManyEntry = {
  source: 'Hello, world!',
  metadata: { dataFormat: 'STRING' }
};
```

## Notes [#notes]

* `DataFormat` determines how content is processed by the translation system.
* Specifying the format in [`EntryMetadata`](/docs/platform/core/reference/types/entry-metadata) ensures correct content processing.
* Auto-detection is possible, but explicitly specifying it is recommended.

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
