Ignore certain dispatcher rules | Community
Skip to main content
Level 2
May 23, 2025
Solved

Ignore certain dispatcher rules

  • May 23, 2025
  • 1 reply
  • 471 views

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!

Best answer by SantoshSai

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.json

Hope this helps!

1 reply

SantoshSai
Community Advisor
SantoshSaiCommunity AdvisorAccepted solution
Community Advisor
May 23, 2025

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.json

Hope this helps!

Santosh Sai
NamitaDuAuthor
Level 2
May 23, 2025

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