Skip to main content

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 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 page.

Asset locales and localizations
Link copied!

Asset locales, together with localizations, allow you 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.

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

In the following sections we'll explain how to add locales to you account, assign locales to assets, create localizations and retrieve localized variants.

Adding locales
Link copied!

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

Choose Locales from the menu in the top right to manage your locales

The locales window opens and will show 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

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

Choosing a locale

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

The locale has been added

Updating locales
Link copied!

You can update or delete existing locales. To update a locale choose "Update" from the cog menu to the left of the locale name and click the Update button.

Updating a locale

Assigning a locale to an asset
Link copied!

There are two ways of assigning a locale to an asset: via bulk upload, 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

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 de-DE locale to the image named "signature-hat-german".

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

Creating a localization
Link copied!

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

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.

Creating the signature hats localization

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

  • 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
Link copied!

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

The assets in the localization will be displayed.

Only the assets in the localization will be displayed

Group locale siblings
Link copied!

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

Updating localizations
Link copied!

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.


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

Working with localized assets
Link copied!

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.

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: