UI distortion when accessing pages through domain URLs in Adobe Experience Manager
In Adobe Experience Manager (AEM), pages accessed through domain URLs can display incorrectly when required client library resources fail to load, resulting in HTTP 404 errors and incomplete page rendering. The issue does not occur when accessing the same pages through publisher or dispatcher URLs. To fix this issue, clear stale cached resources and validate client library delivery across the CDN and dispatcher layers.
Description description
Environment
Adobe Experience Manager (AEM), AEM Sites
Issue/Symptoms
- Pages display with broken or distorted UI when accessed through domain URLs.
- Required client library (clientlib) resources fail to load.
- HTTP 404 errors appear for client library resources.
- Pages render incompletely due to missing assets.
- The issue does not occur when accessing pages through publisher URLs.
- The issue does not occur when accessing pages through dispatcher URLs.
Resolution resolution
Follow these steps to resolve the issue:
- Clear the CDN cache for all affected domain URLs using your CDN management tools or portal. Ensure that the cache is fully purged and not cleared for only some paths.
- After clearing the CDN cache, access the affected URLs in a browser to verify whether the UI distortion is resolved.
- Use browser developer tools to check for any remaining HTTP 404 errors related to client library or static resources.
- If the issue persists, clear the dispatcher cache for the environment. Refer to your dispatcher management procedures to perform a full cache clearance.
- Validate the affected URLs again and check for UI issues or missing resources.
- Ensure that all required client library resources are correctly published and accessible from both the dispatcher and CDN layers. Investigate any remaining 404 errors to confirm that the resources exist on the publisher and aren’t blocked by dispatcher rules.
- If the issue remains unresolved, collect screenshots, affected URLs, and error details for further investigation or escalation.
recommendation-more-help
experience-cloud-kcs-help-kbarticles