Adobe Experience Manager Internationalization

March 13, 2014

In the first GPI blog in the Adobe Experience Manager (Adobe CQ) series (see Setting up Adobe Experience Manager for Multilanguage Websites Part 1), we introduced this powerful platform and how to configure it properly to manage multilingual content through content-centric applications like Workflow Management, Digital Asset Management and Social Collaboration. In this follow up blog, we will provide a refresher on how to configure the CMS for multilingual websites which includes preparing content for translation and using the Adobe CQ Translator module tool.

Setting up Adobe CQ5 for multilingual websites


Adobe CQ Web Content Management System handles multilingual content in a very organized and straightforward way. Following these simple steps, the source content can be easily localized into a number of target languages. Here are the steps needed to enable multilingual content.


First, select the site with the source content you want to translate into other languages then select NEW.




Insert Title and Name. (Name here will be the target language locale and it should be in the following format: <language-code> or <language-code>_<country-code>. Example: en_GB.)




Select the Template and click Create. The main node of the target website will be created.


Prepare Content for translation

Now we need to copy the content to be translated from the source English website into the target one.


First select the web node from the tree in the left column then select Tools > Language Copy.


Select "English+" for each parent node.



Should all website pages need to be localized, select all the Parent nodes of the website using the English+ (en+) and click OK; all nodes should be selected automatically.


Once this process is complete, the new websites with all the pages will be available with the identical structure as the original source website.

Adobe CQ Translator module


CQ Translator Module is a tool to internationalize the content of the UI interface. It uses keys/values to manage and update the related strings between the website's different languages.


To access this tool you need to use CRXDE which is a standalone Eclipse application customized specifically for CQ and CRX for project development purposes. When using CRXDE, be sure that CQ5 is launched and the correct URL, username and password are set.


To demonstrate CQ5 translator functionality, let's suppose that we have a component (Search component for example) with texts/strings such as "Next", "Previous", "Results" etc.


In CRXDE, create a folder with the name "i18n" under Apps\ {Your application}\ {Components}\ {Your control folder}\.


Add a sub folder per target language: (example: es, fr, it).


Add the following properties to each language folder:


  • Jcr:language and set the value to the equivalent target language (i.e. es, nl, fr…)
  • jcrmixinTypes with value mix:language.


Once the above structure is done, the CQ5 Translator tool may now be used to manage the translation of text in the search control:




The CQ5 Translator tool main screen has the following features:


  • Dictionary path: where you can select the path of your application
  • Import: to import translation in XLIFF format
  • Export: export one or more languages for translation in XLIFF format
  • Settings: managing languages
  • Filter by text: search text by different options such as by changes, comments or missing translation


The language columns that appear in the CQ5 Translator tool are the ones you selected in the previous step (under i18n folder). Select Export > Export full {Language name} xliff. The document will be exported in the XLIFF format.


After translation, select Import > XLIFF translation > Browse to the xliff translation and check Overwrite then press OK.


Translation will be imported to the specific language column, saved and reflected in the Search control added to the target language website.

Further GPI Resources on Connectors and Website Development


GPI offers custom CMS Translation Connectors to a variety of web content management systems and client relationship management systems in order to streamline localization workflows and access to translation project information across your enterprise. Connectors and Plug-In's include:



You may also find some of the following articles and links useful:


Further Information on Localization Resources


Globalization Partners International (GPI) helps customers with a range of website translation, multilingual website design and deployment work. In addition GPI has developed a suite of globalization tools to help companies work with language and technology to succeed in global markets. You can explore these translation and localization tools under the translation tools and Portals section of our website. Consider partnering with GPI on your next localization project.

Contact GPI for more information via e-mail at, by phone at (866) 272-5874, or by requesting a free translation quote for your project.

Content Management Systems
Adobe CQ, CMS Translation, CMS, Adobe Experience Manager

Adobe Certifications and Multilingual Desktop PublishingI Survived SXSW 2014!


Currently, there are no comments. Be the first to post one!

Contact Us FREE Globalization eBooks Request Demo Request Quote

Ayman is a native Arabic speaker with extensive expertise in Arabic software and website localization. He is a Microsoft Certified professional (MCP) since 2001 and earned several certificates including MCSD, MCAD, MCTS and MCPD. He has over 12 years’ experience in software / websites engineering using Microsoft Programming tools including C#, ASP.NET, SQL Server, Visual Studio and other tools such as HTML, JavaScript, XML, Ajax and others.