# generaltranslation: General Translation Core SDK: resolveAliasLocale
URL: https://generaltranslation.com/en-US/docs/core/functions/locales/resolve-alias-locale.mdx
---
title: resolveAliasLocale
description: API reference for the resolveAliasLocale function
---

## Overview

The `resolveAliasLocale` function converts canonical locale codes back to their alias locale codes when custom mapping is configured. This standalone function provides the same functionality as the GT class method without requiring an instance.


---

## Reference

### Parameters

<TypeTable
  type={{
    "locale": {
      type: 'string',
      optional: false,
    },
    "customMapping?": {
      type: 'CustomMapping',
      optional: true,
    }
  }}
/>

### Returns

`string` - The alias locale code if mapping exists, otherwise the original locale

---

## Examples

```typescript
import { resolveAliasLocale } from 'generaltranslation';

const customMapping = {
  'simplified-chinese': { code: 'zh-CN', name: 'Simplified Chinese' },
  'traditional-chinese': { code: 'zh-TW', name: 'Traditional Chinese' }
};

// Resolve canonical to alias
console.log(resolveAliasLocale('zh-CN', customMapping)); // 'simplified-chinese'
console.log(resolveAliasLocale('zh-TW', customMapping)); // 'traditional-chinese'

// Non-mapped locale returns original
console.log(resolveAliasLocale('es-ES', customMapping)); // 'es-ES'
```
---

## Notes

- Converts canonical locale codes back to user-friendly aliases
- Returns original locale if no mapping exists
- Essential for displaying user-facing locale names
- Works with custom locale mappings
- Stateless function - no side effects

## Next steps

- Use GT class method [`resolveAliasLocale`](/docs/core/class/methods/locales/resolve-alias-locale)
- Convert to canonical with [`resolveCanonicalLocale`](/docs/core/class/methods/locales/resolve-canonical-locale)