AEM - Annotations Not Working

Please sahre more details like wise console log, error logs to find the root cause of the issue.

Hi @christopherpr1 ,

Follow this, and you'll nail down the issue for sure:

1. Check Browser Console for Errors: Try annotating again and check for:

     - JavaScript errors

     - CORS errors

     - Permission Denied / Unauthorized errors

     - Any failed API endpoints (look for red text)
2. Check Network Tab:

    - Filter by XHR / Fetch

    - Try to annotate → Click the failed request

    - Note the Status Code (e.g., 403, 500)

    - Check Response Body for backend error message

3. Permissions Check — AEM User Access

    - Are you logged in as a user with Annotation privileges?

    - Go to AEM Useradmin → Confirm your user has:

         - read, modify, and replicate permissions on the page

         - /libs, /content, and /etc permissions as needed

    - If unsure, ask your AEM Admin to verify.

4. Page State & Mode — Must Be Editable

     - Annotations only work in Edit mode (not Preview/Published).

     - Confirm the page is not locked or read-only.

     - If it's a published page, annotations might be blocked.

5. Dispatcher Rules / Caching

     - If using Dispatcher, check if it's blocking POST requests to annotation endpoints.

            - Modify dispatcher.any to allow annotation APIs.

     - Try bypassing Dispatcher and annotate directly via the author instance URL.

6. AEM Logs — Server-Side Error?

     - AEM error log: /crx-quickstart/logs/error.log

     - Search for:

 This will confirm if it's backend permission, null data, or server error.

Regards,
Amit

@christopherpr1 Did you find the suggestions helpful? Please let us know if you need more information. If a response worked, kindly mark it as correct for posterity; alternatively, if you found a solution yourself, we’d appreciate it if you could share it with the community. Thank you!