---
title: Add a language
description: How to add a new locale to a version in Marteso so you can manage localized metadata and screenshots for that market.
---

# Add a language to a version

Each version in Marteso can carry metadata in multiple languages. The version detail view shows a separate card for each locale — with its own Screenshots section and App Metadata fields (App Name, Subtitle, Keywords, Description).

## Opening a version

1. In the left sidebar, click **Versions** to expand the section.
2. Click the version you want to add a language to. The version detail opens in the main area.

![Version detail showing the American English locale card with screenshots and metadata fields](/img/versions-overview.png)

The existing locales appear as cards below the **Latest Build** section. Each locale card shows:
- The language name and locale code (e.g., **American English · en-US**)
- **Screenshots** — pulled from the latest build for that locale
- **App Metadata** — App Name, Subtitle, Keywords, Description

## Adding a new locale

To add a language that isn't already listed, scroll to the bottom of the version detail view and look for an **Add Language** option, or use the dropdown on the **Push Metadata** button to access locale management.

For each new locale, fill in:

| Field | Limit | Notes |
|---|---|---|
| **App Name** | 30 characters | Your localized title — research the primary keyword in the target language |
| **Subtitle** | 30 characters | Complement the title — don't repeat the same keyword |
| **Keywords** | 100 characters | Comma-separated, all in the target language |
| **Description** | 4,000 characters | Lead with strong copy in the first 250 visible characters |

Translated text is often longer than English — verify character counts after translation, especially for German and Japanese.

## Read-only versions

Versions with a **Read-only** badge (typically versions that are already **Ready for Sale** on the App Store) have locked metadata. To update metadata for a live version, create a new version and edit the fields there, then push the updated version.

## Pushing localized metadata

After filling in the locale fields, click **Push Metadata** to send the localized metadata to App Store Connect. Marteso pushes all locales within the version in one operation.

See the [Localization guide](../guides/localization.md) for a full keyword research and copy review checklist before pushing localized metadata.