# General Translation Platform: uploadFonts
URL: https://generaltranslation.com/en-GB/docs/platform/core/reference/gt-class-methods/translation/upload-fonts.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Upload persistent font assets for Lottie translation workflows. API reference for uploadFonts.

Uploads TrueType or OpenType fonts through a project so Lottie translation jobs in the same Organization can use them during layout processing.

## Overview [#overview]

Call `uploadFonts` with Base64-encoded font assets. The method splits large inputs into batches of 50 and returns the stored asset identifiers.

```typescript
const result = await gt.uploadFonts(fonts, {
  timeout: 30000,
});
```

Signature:

```typescript
uploadFonts(
  fonts: AssetUpload[],
  options?: UploadAssetsOptions
): Promise<UploadAssetsResponse>
```

*Note: `uploadFonts` requires an `apiKey` (or `devApiKey`) and `projectId` on the GT instance.*

## How it works [#how-it-works]

* Font content is already base64-encoded when passed to the method.
* Each font must have a `.ttf` or `.otf` file name and decode to no more than 20MB.
* The project determines which Organization owns the font. Uploaded fonts persist across that Organization&#39;s translation jobs.
* The service derives font family, weight and italic style from font metadata, then falls back to the file name. Uploading the same derived identity again replaces the stored asset.
* Inputs longer than 50 fonts are uploaded in multiple requests.

(See [Upload project assets](/docs/platform/openapi/reference/project/upload-assets) for validation, identity and retry behaviour).

## Parameters [#parameters]

| Parameter             | Description                     | Type                  | Optional | Default |
| --------------------- | ------------------------------- | --------------------- | -------- | ------- |
| [`fonts`](#fonts)     | Base64-encoded fonts to upload. | `AssetUpload[]`       | No       | —       |
| [`options`](#options) | Request settings.               | `UploadAssetsOptions` | Yes      | `{}`    |

### `fonts` [#fonts]

**Type** `AssetUpload[]` · **Required**

| Field       | Description                           | Type     | Optional |
| ----------- | ------------------------------------- | -------- | -------- |
| `assetType` | Asset type. Only `FONT` is supported. | `'FONT'` | No       |
| `content`   | Base64-encoded font bytes.            | `string` | No       |
| `fileName`  | File name ending in `.ttf` or `.otf`. | `string` | No       |

### `options` [#options]

**Type** `UploadAssetsOptions` · **Optional** · **Default** `{}`

| Field     | Description                      | Type     | Optional |
| --------- | -------------------------------- | -------- | -------- |
| `timeout` | Request timeout in milliseconds. | `number` | Yes      |

## Returns [#returns]

**Type** `Promise<UploadAssetsResponse>`

Resolves with the stored asset identifiers and the number of fonts processed:

| Property            | Description                                                | Type              |
| ------------------- | ---------------------------------------------------------- | ----------------- |
| `assets`            | Stored font assets.                                        | `UploadedAsset[]` |
| `assets[].id`       | Stored Organization asset ID.                              | `string`          |
| `assets[].assetKey` | Derived font identity in the form `<family>-<weight>[-i]`. | `string`          |
| `assets[].fileName` | File name supplied in the upload.                          | `string`          |
| `count`             | Number of fonts processed.                                 | `number`          |

<Callout type="warn">
  **Current v9.1.0 type mismatch:** `UploadedAsset` declares a `deduped` boolean, but the service response does not include it. Do not use that field to detect whether an existing font was replaced.
</Callout>

## Example [#example]

```typescript title="upload-fonts.ts"
import { readFile } from 'node:fs/promises';
import { GT } from 'generaltranslation';

const gt = new GT({
  apiKey: process.env.GT_API_KEY,
  projectId: process.env.GT_PROJECT_ID,
});

const content = (await readFile('./public/fonts/BrandSans.ttf')).toString(
  'base64'
);

const result = await gt.uploadFonts([
  {
    assetType: 'FONT',
    content,
    fileName: 'BrandSans.ttf',
  },
]);

console.log(result.assets[0].assetKey);
```

## Sitemap

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