Delayed content updates in Adobe Experience Manager due to Dispatcher statfileslevel configuration
This article explains how to address delays in content updates appearing on the publish environment after replication from the author environment in Adobe Experience Manager (AEM), focusing on the Dispatcher cache statfileslevel configuration.
Description description
Environment
- Adobe Experience Manager (AEM)
- Dispatcher cache
Issue/Symptoms
- When content is published from the AEM author environment, it should appear promptly on the publish environment.
- Updates to pages or assets may take several hours to appear, even though the replication queue processes items quickly and no errors are reported.
- This issue can affect all types of content.
- The issue occurs regardless of whether the CDN cache is disabled or the Dispatcher cache is manually cleared.
Cause
The Dispatcher cache is not being invalidated as expected because of the statfileslevel configuration. If the statfileslevel value is lower than the depth of the site’s content paths, cache invalidation does not occur for deeper paths, causing stale content to remain until cache expiration.
Resolution resolution
To fix delayed content updates caused by Dispatcher statfileslevel configuration, follow these steps:
- Review your current Dispatcher configuration file (typically
dispatcher.anyordispatcher.yaml). - Locate the
statfileslevelparameter in the/cachesection of the configuration. - Determine the maximum depth of your content paths (for example,
/content/site/section/pageis depth 4). - If your content is nested deeper than the current
statfileslevelvalue, increasestatfileslevelto match or exceed the maximum depth of your content paths. - Save the configuration file, and reload or restart Dispatcher to apply the changes.
- Clear the Dispatcher cache to remove any outdated content.
- Republish a page or asset and verify that the update appears promptly on the publish environment.
- Coordinate with your team to ensure the new
statfileslevelvalue aligns with your caching strategy and does not cause unnecessary cache invalidation.
recommendation-more-help
experience-cloud-kcs-help-kbarticles