# generaltranslation: General Translation Core SDK: CustomMapping
URL: https://generaltranslation.com/es/docs/core/types/custom-mapping.mdx
---
title: CustomMapping
description: Definición de tipo para asignaciones personalizadas de códigos de configuración regional y metadatos ampliados de la configuración regional
---

## Descripción general

`CustomMapping` define asignaciones personalizadas de códigos de configuración regional y metadatos que amplían o sustituyen la información estándar de configuración regional de BCP-47.

```typescript
type CustomMapping = Record<string, string | Partial<LocaleProperties>>;
```


## Definición de tipo

### Estructura

`CustomMapping` es un registro donde:

* **Claves**: códigos de configuración regional personalizados o alias (p. ej., `'simplified-chinese'`, `'company-english'`)
* **Valores**: un nombre de cadena simple o un objeto `LocaleProperties` parcial

### Tipos de valores

| Tipo                        | Descripción                                      | Ejemplo                                             |
| --------------------------- | ------------------------------------------------ | --------------------------------------------------- |
| `string`                    | Nombre para mostrar sencillo                     | `'Simplified Chinese'`                              |
| `Partial<LocaleProperties>` | Metadatos ampliados de la configuración regional | `{ code: 'zh-CN', name: 'Chinese', emoji: '🇨🇳' }` |

***

## Ejemplos

### Asignación simple de cadenas

```typescript copy
const simpleMapping: CustomMapping = {
  'english': 'English',
  'spanish': 'Spanish',
  'mexican-spanish': 'Mexican Spanish'
};

const gt = new GT({
  sourceLocale: 'english',
  targetLocale: 'spanish',
  customMapping: simpleMapping
});
```

### Metadato ampliado de la configuración regional

```typescript copy
const enhancedMapping: CustomMapping = {
  'simplified-chinese': {
    code: 'zh-CN',
    name: 'Simplified Chinese',
    nativeName: '简体中文',
    regionName: 'China',
    emoji: '🇨🇳'
  }
};
```

***

## Notas

* Las asignaciones personalizadas anulan la resolución estándar de configuraciones regionales BCP-47
* Los valores de tipo cadena proporcionan nombres para mostrar simples
* Las LocaleProperties parciales permiten una personalización detallada de la configuración regional
* Las asignaciones personalizadas se resuelven durante la inicialización de la instancia de GT

## Tipos relacionados

* [`LocaleProperties`](/docs/core/types/locale-properties) - Estructura completa de metadatos de la configuración regional