How to disable Link Checker or configure to mark links as valid in AEM


AEM 6.4,6.5

How to disable Link Checker or configure to mark links as valid in AEM

Background:  Whenever a site is loaded in AEM, the Link Checker automatically checks for the embedded links in all the content pages and marks each link as either Valid or Invalid. 

This may slow down an instance or a site due to a large number of Link Checker warnings in the log.  A decision can be made to disable some link checking.  

Note:  The Link Checker should not be enabled on publish instances.  

1. In your pages

  • Add x-cq-linkchecker="valid" parameter in the <a> tag to make sure that links are always mark as valid by the Link Checker. 
  • Optionally use x-cq-linkchecker="skip" in the <a>. Link Checker will not even check for validity.  


2. Disable Link Checker via the AEM Web Console

  • Access the AEM Web Console Configuration [1].
  • Search for Day CQ Link Checker Transformer
  • Check the "Disable Checking" box and click Save.


3. Disable link checking for certain domain

  • Access the AEM Web Console Configuration [1].
  • Search for Day CQ Link Checker Transformer
  • Edit the Link Check Override Patterns setting. 

        Example 1: ^system/

        Any external link starting with system will not be checked.  Add additional override patterns to this section by clicking the +. 

        Example 2: ^

        This will mark all links as as valid moving forward.  

Recommended: Delete all nodes under /var/linkchecker to stop the Link Checker from rechecking URLs.  

[1] http://[host]:[port]/system/console/configMgr