Saturday, 4 February 2017

Adobe Experience Manager FAQs and other Tips

This post captures FAQs, and other tips for AEM that AEM Developers will find useful. We will update this list on an on-going basis.

I am new to AEM, where can i start?

Can I use the Sling API to adapt a  SlingHttpServletRequest?

Yes, you can use the Sling API to adapt from a  SlingHttpServletRequest by using a method such as modelFactory.getModelFromWrappedRequest(). To see a code example of this - see:

I am new to AEM and OSGi
If you are new to AEM and OSGi - read this article --

I want to read the Binary property of a node?

You can use the JCR API to read the binary property of a node and retrieve a Java InputStream. For details, see this article:

I want to update my AEM project to latest version. Is there any recommendations?

How can i add my own template type to Experience Fragments? 

It it is the cq:allowedTemplates property on /content/experience-fragments node that drives the availability of XF variations:

How can I use OSGi R6 Annotations to read OSGi configuration values. 

We cover this use case in these two HELPX articles:

When i search using QueryBuilder, only 10 items are displayed. 

BY default, QueryBuilder only returns 10 results

So add this parameter p.limit=-1 to fix that. For example-- 

 //set QueryBuilder search criteria                   
  map.put("type", "cq:Page");
  map.put("path", "/content/we-retail"); 
  map.put("p.limit", "-1");

I want to understand Dispatcher better
See this community content --

How can I view all the Node Types in AEM? 

See: http://localhost:4502/crx/explorer/nodetypes/index.jsp

Whats the Difference between an Experience Fragment and a Content Fragment? 

Does AEM Support SPA?

See these resources:

Some of the documentation we have for that:

The RTE Editor plug-in are not visible until I click within the RTE. How can i fix?

How can i use HTL syntax to include a clientlib
use this syntax --  <sly data-sly-use.clientLib="/libs/granite/sightly/templates/clientlib.html" data-sly-call="${clientLib.js @ categories='cq.jquerycar'}" data-sly-unwrap/>

What are Design Dialogs used for? 

Design Dialogs allow a user to update the Policy of a component. When working with structural components that will be re-used across templates it is advantageous to use Policies since the policy can be applied across templates. See this article for more information --

How can I define a new path for a Sling Servlet

Can I use a Radio data type in a Multi-field?
See this video  --

I want to know about how Sling locates resources

How can I created a nested Coral 3 Multi-field

I want to know more about DS Annotations

I want to use sling models to retrieve Multi-field values using sling models
This is a straightforward use case. See this article for details --

How to print the jcr:lastModified using HTL without writing a java class
You can use the following syntax:

${properties['jcr:lastModified'] @format='dd/MM/yyyy'}

Can I use OAuth in AEM? 
Can I programmatically remove a user from groups?

You can use the UserManager API. Use the following code: 

Authorizable groupAuthorizable = userManager.getAuthorizable(group);
if (groupAuthorizable != null && groupAuthorizable instanceof Group) {
        ((Group) groupAuthorizable).removeMember(user);


Can I use an API to update OSGi configuration values

How can I add a FAVICON to an AEM Site

How can I create a Nested Touch UI Multifield? 

How can I extend Core Components?

How can I create an OAK Index

Unlike Jackrabbit 2, Oak does not index content by default. Custom indexes need to be created when necessary, much like with traditional relational databases. If there is no index for a specific query, possibly many nodes will be traversed. The query may still work but probably be very slow. 

To avoid performance issues, you need to create an OAK index. See these resources for more information:

2. GEMS Session on OAK Index

I want to see a basic Architecture diagram for AEM

I want to start migrating data from a non-AEM site to AEM

How come I cannot use Design Mode for We Retail?

If you attempt to use Design Mode for We Retail in order to add new components, you will notice that Design mode is not there. 

The reason is pages based on Editable Templates do not have Design Mode. To add a component group, you need to add the component group by using the editable templates Policy. 

For information about working with Policies and editable templates - see this article -

I am trying to render a RTE value in HTL, but is displayed as HTML Tags - not HTML content? 
If you want to read the value of a RTE and display in a HTL component - along with the tags such as a hyperlink, you need to use this HTL syntax:

${head.text @ context='html'}

where head.text is the RTE value. 

What are Projects in AEM? 

See this link  - Developing Projects in AEM.

How can I test my AEM Code? 
You can test your AEM Java code by using the Test class that is generated for you when you build an Adobe Maven 11 Archetype project. See

 For example, assume you create a project named AEM633. Once you build this project, you will have a class named TestHelloWorldModel located in this package: (under src\test\java)  

All of the POM dependencies are set up for you. Create a simple interface in the Core package named Foo


public interface Foo {

public String getName(); 


Then create an implementation class that uses a @Component annotation in the same package. 


import org.osgi.service.component.annotations.Component;

public class FooImpl implements Foo{

public String getName()
return "Scott" ; 


This is about the most basic AEM class that you can build. It has one method that returns a static value for the getName method. Now the question is how can we test this method? 

The answer is to use the TestHelloWorldModel class that already exists. You can create a Foo object and then test the getName method. See the bold code below. 


import static org.junit.Assert.assertNotNull;

import static org.junit.Assert.assertTrue;

import static org.mockito.Mockito.mock;

import static org.mockito.Mockito.when;

import java.util.UUID;

import junitx.util.PrivateAccessor;


import org.junit.Before;

import org.junit.Test;




 * Simple JUnit test verifying the HelloWorldModel


public class TestHelloWorldModel {


    private HelloWorldModel hello;


    private Foo myFoo;  


    private String slingId;




    public void setup() throws Exception {

        SlingSettingsService settings = mock(SlingSettingsService.class);

        slingId = UUID.randomUUID().toString();


        hello = new HelloWorldModel();

        PrivateAccessor.setField(hello, "settings", settings);



        myFoo = new FooImpl(); 





    public void testGetMessage() throws Exception {

        // some very basic junit tests

        String msg = hello.getMessage();


        assertTrue(msg.length() > 0);



    public void testFooMessage() throws Exception {
        //custom service
        String msgFoo = myFoo.getName() ; 
        assertTrue(msgFoo.length() > 0);


When you build the Maven project (for example, mvn clean install), you can see the Test results that are written to this file:


For AEM and MOCK examples - see:

How can I disable the options in the Assets Toolbar? 

I have a requirement to remove options on the Assets toolbar. 

If you simply want to disable those, you can overlay:


and add disabled (boolean) = true for these actions

How can I apply color to a Table in the RTE? 

This works as shown here: 

I need to create a QUIZ in AEM. Can I use AEM Forms?

You cannot use AEM Forms to create a quiz component. It's best to use a JQuery plugin and develop a custom component as discussed here: 

How can I configure AEM Link Checker to ignore certain URL patterns

See this community thread --

How do you display a DATE value in HTL? 

Assume you have a node named startDate, which is based on a Date data type. To display this value in HTL, you can use the following HTL syntax. 

${'yyyy-MM-dd HH:mm:ss.SSSXXX' @ format=head.startDate, timezone='UTC'}

How can I used GSON within AEM

To use the GSON XML library in AEM, you need to use the following dependency. 



How can I track Requests in AEM? 

You can use the "Recent requests" view in the web console ( /system/console/requests) to actually check what the request is internally doing. Every include and every forward is listed there and this should give you insight what's going on.

How can i align fields in a Touch UI Dialog? 

How can I use Sling Queries?

Core Project has dependency on javax.inject [0,1) Bundles and imports not getting deployed 
You can add

<!-- Import any version of javax.inject, to allow running on multiple versions of AEM -->

to your bundles pom.xml. This should solve your issue. This says take any version from the felix console for this bundle.  Add it under maven-scr-plugin 

How can I use an AEM API to find all Assets in a page?

How come when a Workflow is assigned to 1 user, sometimes another user can see it 

Assume you have two users:
  • User A
  • User B

Next, assume that you have a Workflow model that uses an OR Split and where the 1st step is assigned to User A.   See this model. 

Sometimes even if User A is assigned the a Workflow task- it may show up in User B inbox. This may happen if you have not specified User A as the 1st step. Also - it may happen if they Users are part of the workflow admin group.  In order for User B not to see a task assigned to another member, ensure that they both belong to the workflow-users group. 

Notice that User A is assigned a task when the workflow is started. Even if User B invokes the Workflow, a message is sent to User A - as shown here: 

Although User B invoked the Workflow, they do not get a message in their corresponding inbox. 

How can I get a reference to an AEM Service from a Sling Model

You cannot use @Reference to inject a service into a Sling Model. When attempting to get a service into an AEM Sling Model class - you can use @inject. See this thread:

How can I limit the fields located in Multifield?

How can i change the Theme of a Touch UI Dialog? 

How can i modify the default text of a Parsys component? 
Where can I find good reference docs for Coral APIs

How do i use HTL syntax to include a Core Component in my static template?

You can use HTL syntax to include AEM Core components into a static template. For example, to include the List component into a template - specify this syntax: 

<div data-sly-resource="${'content' @ resourceType='core/wcm/components/list/v1/list'}">

Whats the difference between a static template and an editable template

In AEM 6.3 - I am getting osgi bundle whitelist error-osgi-service is NOT whitelisted to use SlingRepository.loginAdministrative 

You can either use a System user and the sling mapping service:

Or configure AEM -

How can i integrate AEM with Hybris? 

In HTL, how can i add the parsys component?

Add this code:

<sly data-sly-resource="${'content-par' @ resourceType='wcm/foundation/components/parsys'}"/>

I can use both JCR API and SLing API to work with the AEM JCR. Which one is better? 

I want to send a message to a users AEM inbox? 

When working with Sling Models, can I reference grandchildren nodes and work with Collections? 

Yes, when you work with Sling Models, you can work with Grandchildren nodes from the node that you adapt. For example, consider the following JCR structure. 

Assume you adapt NodeCollections in your Sling Model: 

Resource resource = resourceResolver.getResource("/content/NodeCollections");

You can get the grandchildren nodes using this syntax and return them to  a Java LIST object. 

@Model(adaptables = Resource.class)
public class UserInfo {
private List<Resource> Dad;

    public List getGrandChildren()
    return Dad ; 


In this example, the List Object would contain six items.  See more here:

I want to know the difference between Sling Models and WCMUsePojo

Can Forms interact with Workflows? 

I want to know more information about OSGi Declarative Services Annotations in AEM

Whats the difference between Foundation components and Core components? 

See this community article for an answer:

To learn to work with Core Components - see:

A user does not have permission to modify Assets, can they execute a Workflow that modifies them? 

Any member of the workflow-users group can list and start workflows, irrespective of their permissions on the payload the selected to run the workflow.

Does AEM by default use J2EE Sessions and Cookies? 
Nothing in AEM uses JavaEE Sessions.  

Components cannot be moved. Why? 

If you want to move components upwards or downwards, you need to use copymove in cq:actions property.

Here it is!!

<jcr:root xmlns:cq="" xmlns:jcr=""

    cq:actions="[text:My Component,-,edit,delete,insert,copymove]"





I  am using AEM Forms, not AEM Sites
See these docs:

Can I use @Reference in an HTL Class that extends WCMUsePojo

You cannot use the @Reference annotation from a HTL class that extends WCMUsePojo. This can be used from a Java class that uses @Service to reference another service known as dependency injection. To learn about Dependency Injection in AEM, see this article: 

Now to learn how to get a referenece to another AEM service from a class that extends WCMUsePojo, see this article: 

Can I use @Reference  from within a Sling Servlet

You can use Dependency Injection from within a Sling Servlet. See this community article/video. 

Can I manipulate the Touch UI Rich Text Editor using code

See this community article -

How can I programmatically retrieve HTML from an AEM page

See this great community article by Nolle Yolles:

What is cq.editconfig and when should i use it

Where do Lucene, Solr, ElasticSearch fit in the AEM Platform? 

Can i view an asset's metadata in CRXDE lite? 

Assume you have added metadata to a digital asset, as shown in this illustration. 

You can view the assets metadata by viewing a node named metadata under the asset in the AEM dam (/content/dam). For example, the above image is located here:


The metadata is stored as node properties as shown in this illustration.

Can I programmatically work with Coral UI object such as checkboxes?

Yes you can. It involves creating a JS script in an AEM Clientlib and then coding. See the reference documentation here:

Given this setup in CRXDE Lite: 

You can get a reference to this checkbox object in a clientlibs folder. The name of the clientlibs folder for Touch UI dialogs is cq.authoring.dialog ( this is talked about here.


(function ($, $document) {
    "use strict";


    $document.on("dialog-ready", function() {

        $('#kitten').attr('checked', true);     


})(jQuery, jQuery(document));

The result is the checkbox is checked via code: 

Note - we are planning on conducting a full session of AEM Ask the Community Experts on AEM Developing with the Coral API. 

Need to search for special characters when searching JCR via JCR SQL2

Read this topic -- YOU  need to escape illegal JCR characters.

How can i work with custom JARs that are not in the Maven repository

You can place the JAR in your local Maven Repository and then reference it in your POM file. For example, to resolve myCustomJAR_1.0.0.jar within an AEM service, the myCustomJAR_1.0.0.jar file must be located in the Maven repository. You can upload the myCustomJAR_1.0.0.jar to Maven by using this Maven command: 

mvn install:install-file -Dfile=C:/plugins/myCustomJAR_1.0.0.jar -DartifactId=jrurbersrt1.0 -Dversion=1.0 -Dpackaging=jar -DgeneratePom=true

Notice that you must specify the location of the myCustomJAR file in the -Dfile argument. Also notice that you specify the Dgroup and DartifactID values. Once you upload the JAR to Maven using this command, you can reference this JAR file using this Dependency.


Notice that scope element is system and systemPath references the location of the JAR file in the repository. (This dependency is used later in this article to build the AEM service) 

How can i work with 3rd party JARs when i create an OSGi bundle

When working with OSGi bundles that use 3rd party JARs (that are located in the Maven Repository), you can embed the 3rd party JAR (for example, Simple JSON JAR) into a separate bundle and deploy to AEM. See this community article/video for details.

Enable CORS Access-Control-Allow-Origin in AEM

If you use the default AEM JQuery, it has a token that lets you perform AJAX operations to AEM. 

AEM is experiencing slow page loading

How does Dispatcher Caching work

The dispatcher caches only files which have an extension; and the extensions which should be considered for caching can be configured in the dispatcher config as part of the caching rules.

So you need to add an extension to your service request (e.g. ".json"), and configure the dispatcher accordingly, then the caching will work.

 Capturing comments in a default email template used by an AEM 6.2 workflow

You can write a custom workflow step and inject values you want to populate into a email template with Java logic. For example: 

//Populate the MAP with the values 
 //Declare a MessageGateway service
 MessageGateway<HtmlEmail> messageGateway; 
 //Specify the EMail template 
 String template ="/etc/notification/email/html/";
 Resource templateRsrc = request.getResourceResolver().getResource(template);
 MailTemplate mailTemplate = MailTemplate.create(templateRsrc.getPath(), templateRsrc.getResourceResolver().adaptTo(Session.class));
 HtmlEmail email = mailTemplate.getEmail(StrLookup.mapLookup(myMap), HtmlEmail.class);

A solution without coding is to use the variable ${} in the default en.txt. To see other variables that can be used, see the Workflow Email Notification Service.

com.adobe.granite.crxde-lite reinstall in publisher

Recently we observed com.adobe.granite.crxde-lite bundle is not present/got deleted in publisher node. Due to this reason we are not able to login to http://localhost:4503/crx/de

To solve this - Try the following actions:

1. On author log into OSGi /system/console/bundles.
2. Type CRX in the search field and click Apply filter 
3. Most likely Adobe Granite CRXDE Lite com.adobe.granite.crxde-lite bundle is missing, however, you can do the same search on Publish and compare the result to indetify the difference.
4. Note Adobe Granite CRXDE bundle ID, in my sample, it is 222.
5. On your AEM author navigate to /crx-quickstart/launchpad/felix/bundle222 /AEM64/author/crx-quickstart/launchpad/felix/bundle222/version0.0
6. Deploy bundle.jar to AEM publish via /system/console/bundles -> Install/Update...

Join the Experience League

To become an Experience Business, you need more than just great tools and online help. You need a partner. Experience League is a new enablement program with guided learning to help you get the most out of Adobe Experience Cloud. With training materials, one-to-one expert support, and a thriving community of fellow professionals, Experience League is a comprehensive program designed to help you become your best.

Join the Adobe Experience League by clicking this banner.

I (Scott Macdonald) am a Senior Experience League Community Manager at Adobe Systems with 20 years in the high tech industry. I am also a programmer with knowledge in Java, JavaScript, C#,C++, HTML, XML and ActionScript. If  you would like to see more AEM or other end to end articles like this, then leave a comment and let me know what content you would like to see.

Twitter: Follow the Digital Marketing Customer Care team on Twitter @AdobeExpCare.


  1. This comment has been removed by a blog administrator.

  2. Regarding CORS, how AEM jQuery can help if the content hosted on AEM needs to be accessed by non AEM third-party?

    1. In this use case - we are assuming everything is in AEM - ie code in a component is making an AJAX request to a Sling Servlet

    2. This might not be the best solution but you can enable cors by following and use jsoup on your 3rd party application. Else you can expose your content as JSON in a content-as-a-service way

  3. Hi Scott,

    I have custom workflow launchers in my project. All the launchers were working fine but suddenly it stopped working. Few days back I have installed service pack 1and CFP, is it causing these issues ? I'm using AEM 6.3 along with ACS commons.

    We are in UAT stage of our project. Kindly provide me the solution ASAP

  4. This is such a great resource that you are providing and you give it away for free. I love seeing blog that understand the value. Im glad to have found this post as its such an interesting one! I am always on the lookout for quality posts and articles so i suppose im lucky to have found this! I hope you will be adding more in the future… for any kind of Adobe support you can call us 0800-090-3240 or visit Adobe phone number uk.

  5. This comment has been removed by a blog administrator.

  6. This comment has been removed by a blog administrator.