---
canonical: https://amplience.com/developers/docs/user-guides/assets/locate/locales/
title: Content Hub asset locales
description: User guide for Content Hub asset locales explaining how to assign locales to assets in Content Hub, group assets into localizations, and find localized assets.
audience: Business User
image: https://cdn.media.amplience.net/i/ampproduct/content-hub-locales-1-new?w=1200&h=630
image_width: 1200
image_height: 630
date_published: 2022-07-04
date_modified: 2024-11-21
---

# Content Hub asset locales

Being able to retrieve localized variants of an asset is particularly useful if an image isn't suitable for certain countries, and in those countries you want to use a localized variant instead. You might also have a campaign that uses different images and text for different countries. On this page we'll explain how you can assign locales to assets in Content Hub, group assets into localizations, and use [Dynamic Media](https://amplience.com/developers/docs/apis/media-delivery/media-delivery-reference) to retrieve a localized variant of any asset in a localization from any other asset in that group.

The information on this page refers to assigning locales to assets in Content Hub and retrieving localized variants of assets using Dynamic Media. To find out about working with localized content items in Dynamic Content, visit the [localization overview](https://amplience.com/developers/docs/user-guides/produce-content/localize) page.

> **Info: Assets, locales and images**
> Asset locales are independent from the locales which are used for setting up [automatic image alt text generation](https://amplience.com/developers/docs/user-guides/assets/working-with-assets/auto-alt-text-generation/).

## Asset locales and localizations

Asset locales, together with localizations, allow you to organize your assets to serve localized variants of an asset for different countries and regions. A locale is a combination of a language, for example French, English or Bulgarian, and an optional country variant, such as France or Belgium. For example, you might use fr-FR for France, and fr-BE for French content for use in Belgium.

To retrieve a variant of an asset based on its locale, assets are grouped together in a localization, with each asset assigned a unique locale. You can use any asset in the localization to retrieve any other asset in the group by specifying a locale. Asset names must be unique, so the localization is a way of associating assets with each other.

The following Dynamic Media URL shows how to retrieve the French variant of another asset in its localization.

```
https://cdn.media.amplience.net/i/ampproduct/signature-hat-german?locale=fr-FR
```

If there is no asset in the localization assigned the "fr-FR" locale, then an error will be returned.

## Adding locales

Locales are specified at the account level and you need administrator access to add locales to an account. To add a locale, choose "My account" from the menu in the top right of the window.

![Choose My account from the menu to manage your locales](https://cdn.media.amplience.net/i/ampproduct/content-hub-locales-1-new?w=1880&fmt=png 'Choose My account from the menu to manage your locales')

The Settings window opens, from which you choose "Locales". The Locales pane is displayed and shows any locales on your account. You can specify that locales can be applied by default to assets at the account or user level.

To add a new locale click the New button as shown.

![Adding a new locale](https://cdn.media.amplience.net/i/ampproduct/content-hub-locales-2?w=1880&fmt=png 'Adding a new locale')

Choose the Locale and the optional variant and click the Add button.

![Choosing a locale](https://cdn.media.amplience.net/i/ampproduct/content-hub-locales-3?w=1880&fmt=png 'Choosing a locale')

The Locale is added to your account and is now available to assign to assets.

![The locale has been added](https://cdn.media.amplience.net/i/ampproduct/content-hub-locales-4?w=1880&fmt=png 'The locale has been added')

## Updating locales

You can update or delete existing locales. To update a locale, hover the cursor to the left of the locale name, and choose "Update" from the cog menu. Make your changes, then click the Update button.

![Updating a locale](https://cdn.media.amplience.net/i/ampproduct/content-hub-locales-5?w=1880&fmt=png 'Updating a locale')

## Assigning a locale to an asset

There are two ways of assigning a locale to an asset: via [bulk upload](https://amplience.com/developers/docs/user-guides/basics/content-hub/tools#upload-connectors), or manually using Content Hub. When using bulk upload you can assign a default locale to assets by selecting "Advanced job options" and choosing a default locale to apply to all assets ingested with that upload job.

![A default locale can be assigned to assets ingested via bulk upload](https://cdn.media.amplience.net/i/ampproduct/content-hub-locales-16?w=1880&fmt=png 'A default locale can be assigned to assets ingested via bulk upload')

To manually assign a locale to an asset, choose "Set locale" from the Asset menu and select the locale you want to assign from the list. In this example we want to assign the fr-FR locale to the image named "hat-woman-french".

![Choose Set Locale to set an asset's locale](https://cdn.media.amplience.net/i/ampproduct/content-hub-locales-7-new?w=1880&fmt=png "Choose Set Locale to set an asset's locale")

The locale label at the top of the asset's card is updated with the new locale.

![The locale label is shown on the asset's card](https://cdn.media.amplience.net/i/ampproduct/content-hub-locales-8-new?w=1880&fmt=png "The locale label is shown on the asset's card")

## Creating a localization

Localization groups are a way of organizing related assets so that you can use any assets to retrieve one of its "siblings"- that is a variant of the asset which has been assigned a different locale.

To create a localization group, select an asset and choose "Create localization" from the asset menu.

![Creating a localization](https://cdn.media.amplience.net/i/ampproduct/content-hub-locales-9-new?w=1880&fmt=png 'Creating a localization')

The localization window opens. From here you can give the localization a name, add assets to the group and update the locale for one or more of the assets. To add assets to the localization, select and drag the assets to the localization window.

In this example we've added three assets from our signature hat collection and assigned each of them a different locale. When you've added all the assets you want to include, click the "Create" button.

![Assets can be added by dragging them to the localization window](https://cdn.media.amplience.net/i/ampproduct/content-hub-locales-11-new?w=1880&fmt=png 'Assets can be added by dragging them to the localization window')

> **Info:** - Assets in a localization must have unique locales
> - Assets in a localization must all be the same type. You can add images and text to a localization, but they cannot be added to the same localization.
> - Video assets cannot be added to a localization

### Viewing locale variants

When an asset has been added to a localization, you can view its variants by right-clicking the asset and choosing "Show locale variants".

![Choose show locale variants to display the other assets in the localization](https://cdn.media.amplience.net/i/ampproduct/content-hub-locales-17?w=1880&fmt=png 'Choose show locale variants to display the other assets in the localization')

The assets in the localization will be displayed.

![Only the assets in the localization will be displayed](https://cdn.media.amplience.net/i/ampproduct/content-hub-locales-18?w=1880&fmt=png 'Only the assets in the localization will be displayed')

### Group locale siblings

To make it easier to work with localizations, you can choose to group the assets in a localization together so that they are shown first. To do this select the "Group locale siblings" icon as highlighted below.

The localizations are shown, with the first asset in the localization displayed, together with the number of assets in the group. Click the down arrow to show information about the localization.

![Select the group locale siblings icon to show your localizations](https://cdn.media.amplience.net/i/ampproduct/content-hub-locales-12?w=1880&fmt=png 'Select the group locale siblings icon to show your localizations')

## Updating localizations

With the "Group locale siblings" option selected you can view and edit a localization. Choose "Update localization" from the asset menu as shown below. You can update the locale of each asset in the localization. Hover over an asset and click the "x" to remove it from the localization.

> **Note:** You can only update the locale of an asset that is part of a localization from within the localization window.

![You can add assets to or remove assets from a localization or update locales](https://cdn.media.amplience.net/i/ampproduct/content-hub-locales-14?w=1880&fmt=png 'You can add assets to or remove assets from a localization or update locales')

## Working with localized assets

You can use any asset in a localization to retrieve another asset in the localization based on its locale. So in the example below, we can request the French variant of "signature-hat-german" as follows.

```
https://cdn.media.amplience.net/i/ampproduct/signature-hat-german?locale=fr-FR
```

![You can use any asset in a localization to retrieve one of its siblings using its locale](https://cdn.media.amplience.net/i/ampproduct/content-hub-locales-15?w=400 'You can use any asset in a localization to retrieve one of its siblings using its locale')

You can also add other Dynamic Media parameters to the URL. For example:

```
https://cdn.media.amplience.net/i/ampproduct/signature-hat-german?locale=fr-FR&w=300
```