Use Locale and LocaleMap for images | Scene7


Can I set up the LocaleMap in SPS to call different images based on language or regional requirements?


You set up the locale lookup map in SPS Application Setup > Publish Setup > Image Server. For more information, see


  1. Set Default Locale to en.
  2. Set Locale Map to en,_en,|he,_he|zh,_zh|de,_de,.
  3. Upload three images titled "hello," 'hello_he," and "hello_zh."

If you try a URL that does not have a locale defined in the Locale Map, a 404 error occurs:

The error includes this message:
"Unknown locale: fr - no default rule defined."

If you now want to support France, add | Fr, _fr, to the locale map, and add an image called "hello_fr."

But, if you call the German locale (de), the Locale Map is defined for de, but no image called "image_de" exists. So it fails back to the default image--in this case, en ("hello").

Locale, as it is today, only applies if you append the locale given in the locale map.

There is no translation of the members of a set, as it is assumed each is called individually with the locale to translate.

Actually, it is a lookup mechanism, which should provide the default locale if the locale map is properly configured.

You can check the lookup order using &req=xlate

Because you defined: en,_en, it also looks for "hello" and not only for "hello_en."