# 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 metadato ampliado de la configuración regional
---

## Resumen

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

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


## Definición de tipo

### Estructura

`CustomMapping` es un registro donde:

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

### Tipos de valor

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

***

## Ejemplos

### Asignaciones de cadenas simples

```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 sobrescriben la resolución estándar de configuraciones regionales según BCP-47
* Los valores de cadena proporcionan nombres de visualización sencillos
* Los 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