Expand my Community achievements bar.

July 31st AEM Gems Webinar: Elevate your AEM development to master the integration of private GitHub repositories within AEM Cloud Manager.

Tags issue in Cloud DEV publisher


Level 2

Hi, We have tags as /content/cq:tags/xyz/region, we are trying to resolve them using Tag Manager object:

ex: tagManager.resolve("/content/cq:tags/xyz/region") and tagManager.resolve(xyz:region)

both of them got resolved in author instance but failing in publisher(in local publisher they got resolved).

We checked from Dev console and tags are still there in DEV Publisher and tagManager object is not null.


5 Replies


Level 10

Hi @chalamcharla ,

If the tagManager.resolve() method is failing to resolve tags in the Cloud DEV publisher environment but works fine in the local publisher and author instances, there could be several reasons for this behavior. Here are some steps you can take to troubleshoot and resolve the issue:

  1. Verify Tag Path:

    • Double-check the path to the tags you are trying to resolve. Ensure that the path is correct and matches the actual location of the tags in the Cloud DEV publisher environment.
  2. Check Permissions:

    • Ensure that the user context under which the code is running has the necessary permissions to access and resolve tags. Permissions might differ between environments, so ensure that the user has the appropriate permissions in the Cloud DEV publisher environment.
  3. Replication Issues:

    • Check if there are any issues with content replication between the author and publisher instances in the Cloud DEV environment. If tags are not replicated properly, they may not be available for resolution on the publisher.
  4. Cache or Indexing Issues:

    • Investigate if there are any cache or indexing issues affecting tag resolution in the Cloud DEV publisher environment. Flushing the cache or re-indexing the repository might help resolve any inconsistencies.
  5. Logging and Debugging:

    • Enable debug logging for tag resolution operations in the Cloud DEV publisher environment. This can provide more insight into why the tags are failing to resolve and help identify any underlying issues.
  6. Environment Configuration:

    • Ensure that the Cloud DEV publisher environment is properly configured and that all necessary services and components required for tag resolution are running correctly.
  7. Network or Firewall Restrictions:

    • Check if there are any network or firewall restrictions that might be preventing the Cloud DEV publisher from accessing the tags or related resources.
  8. Consult Adobe Support:

    • If you are unable to resolve the issue through troubleshooting, consider reaching out to Adobe Support for assistance. They can provide further guidance and help diagnose any underlying issues with the Cloud DEV publisher environment.

By following these steps and investigating potential causes, you should be able to identify and address the issue with tag resolution in the Cloud DEV publisher environment.


Level 9



You can try the below:

  • Compare the Tag Manager configurations and permissions between the author and publisher instances to identify any differences.
  • Check the replication logs and ensuring the tags are being replicated correctly.
  • Check the permissions and ensuring the appropriate rights are granted.


Community Advisor

Resolving tags in AEM can sometimes encounter issues due to configuration differences between author and publisher instances, or due to differences in the content repositories. Here are a few steps you can follow to troubleshoot and resolve this issue:

Steps to Troubleshoot and Resolve Tag Resolution Issues:

  1. Check Tag Synchronization: Ensure that tags are properly synchronized between your author and publisher instances. Tags created or modified on the author instance should be replicated to the publisher instance.

  2. Permissions and ACLs: Verify that the service user or the user context running the tagManager.resolve method has the appropriate permissions to read the tags in the /content/cq:tags path on the publisher instance. Sometimes, discrepancies in permissions can lead to issues where tags are accessible in the author but not in the publisher.

  3. Cache Issues: Clear the cache on the publisher instance. Sometimes, stale cache can cause discrepancies in how tags are resolved.

  4. Code and Configuration Differences: Ensure that there are no code differences or configuration discrepancies between the author and publisher instances. Check the configurations related to the Tag Manager and tag resolution.

  5. Replicate the Tags: Manually replicate the tags from the author instance to the publisher instance to ensure that the latest tag definitions are available on the publisher.

Example Code to Resolve Tags:

Here is an example of how you can use the TagManager to resolve tags in AEM:

import com.day.cq.tagging.Tag;
import com.day.cq.tagging.TagManager;
import org.apache.sling.api.resource.ResourceResolver;
import org.apache.sling.api.resource.Resource;

public class TagResolutionExample {
    public Tag resolveTag(ResourceResolver resourceResolver, String tagPathOrId) {
        TagManager tagManager = resourceResolver.adaptTo(TagManager.class);
        if (tagManager != null) {
            Tag tag = tagManager.resolve(tagPathOrId);
            if (tag != null) {
                return tag;
            } else {
                System.out.println("Tag not found: " + tagPathOrId);
        } else {
            System.out.println("TagManager is null");
        return null;

    public static void main(String[] args) {
        // Assuming resourceResolver is already available
        ResourceResolver resourceResolver = ...;

        TagResolutionExample example = new TagResolutionExample();
        Tag tag1 = example.resolveTag(resourceResolver, "/content/cq:tags/xyz/region");
        Tag tag2 = example.resolveTag(resourceResolver, "xyz:region");

        if (tag1 != null) {
            System.out.println("Resolved tag: " + tag1.getTitle());

        if (tag2 != null) {
            System.out.println("Resolved tag: " + tag2.getTitle());

Additional Troubleshooting Steps:

  • Log Analysis: Check the logs on the publisher instance for any errors or warnings related to tag resolution or TagManager. This can provide more insights into what might be going wrong.

  • Replicate Tag Definitions: Manually check the tag definitions on both author and publisher to ensure they are identical. If there are differences, replicate the tags from author to publisher.

  • Check OSGi Configurations: Ensure that the OSGi configurations for the Tag Manager and any related services are identical on both the author and publisher instances.

  • AEM Version and Patches: Ensure that both author and publisher instances are running the same version of AEM and have the same patches applied. Sometimes, bugs or discrepancies between versions can cause such issues.


The key is to ensure synchronization and identical configurations between your author and publisher instances. By following the steps above, you should be able to identify and resolve the issue with tag resolution in your publisher instance. If the problem persists, consider reaching out to Adobe support for further assistance.



@chalamcharla Did you find the suggestion helpful? Please let us know if more information is required. Otherwise, please mark the answer as correct for posterity. If you have found out solution yourself, please share it with the community.

Kautuk Sahni


Level 2

Hi, the above steps didn't resolved the issue, we are in connect with adobe support