Ignore certain dispatcher rules

[NamitaDu]

Hi all,
I'm using the AEM Dispatcher Optimizer Tool (DOT) https://github.com/adobe/aem-dispatcher-optimizer-tool to validate my dispatcher configurations. It works well, but I’d like to exclude or ignore certain rules from validation (eg. specific filter rules or cache sections that are intentionally customized for our use case).

Is there a way to skip or disable specific validations when running DOT?

Thanks in advance!

[SantoshSai · Accepted solution]

Hi @NamitaDu,

Yes, you can absolutely skip specific validations when using DOT.

The DOT tool allows you to disable specific rule categories or individual rule IDs using the --exclude flag. This is useful when your project has valid use cases that intentionally deviate from Adobe’s best practices.

Example:

java -jar aem-dispatcher-optimizer-tool.jar \
  --dispatcher-config ./dispatcher \
  --exclude FILTER_ALLOW_EMPTY, CACHE_MISSING_HEADER

In this command:

• FILTER_ALLOW_EMPTY and CACHE_MISSING_HEADER are example rule IDs you want to exclude.

• You can exclude as many as needed, comma-separated.

You can find a full list of rules and options in the official DOT documentation here:
https://github.com/adobe/aem-dispatcher-optimizer-tool/blob/main/docs/Rules.md

This approach gives you flexibility while still benefiting from most of DOT’s validations. Let me know if you need help identifying the rule IDs from your report logs!

Also, this file contains the rule IDs and their configurations, which can be useful if you're looking to customize or extend the rule set:
https://github.com/adobe/aem-dispatcher-optimizer-tool/blob/main/core/src/main/resources/core-rules....

Hope this helps!

[NamitaDu]

@SantoshSaiThank you, I was actually looking for the core rules list - I couldn’t find it earlier.