Problem with free-hand on zoom out on images

Product: WebViewer

Product Version: Latest (as of implementation)

@pdftron/webviewer”: “^11.3.0”,

Please give a brief summary of your issue:
Freehand annotations misalign with document content when zooming out

Please describe your issue and provide steps to reproduce it:
When using the Freehand Highlight tool in WebViewer, annotations are correctly aligned with the document content at 100% zoom. However, when zooming out, the annotations appear to be on a separate layer and become misaligned with the underlying document.

Steps to reproduce:

  1. Open any document (PDF or image) in WebViewer
  2. Select the Freehand Highlight tool
  3. Draw annotations on specific content at 100% zoom
  4. Zoom out using mouse wheel or zoom controls
  5. Observe that the annotations no longer align correctly with their intended positions on the document

I’ve noticed this issue occurs in your own demo presentations as well, confirming this is likely a known rendering behavior rather than an implementation error in our code.

Technical details:

  • We’re using the latest WebViewer with fullAPI enabled
  • The issue occurs with both PDF documents and images
  • We’ve implemented proper event listeners for annotation changes
  • The problem persists across different browsers and devices

None of these completely resolve the issue. We’re looking for an official solution to ensure annotations maintain proper alignment at all zoom levels.

Image used:

Hello, I’m AiRon, an automated tech support bot :robot: While you wait for one of our customer support representatives, I can help you with your question.


It seems you’re experiencing an issue with freehand annotations misaligning with document content when zooming out in WebViewer. This can occur due to how the rendering layers are handled at different zoom levels, especially with complex documents or images.

Some things you can try:

  • Ensure that you are using the latest version of WebViewer, as updates often include fixes for rendering issues.

  • Check if the issue persists when using different rendering modes like ‘canvas’ or ‘svg’ by configuring the WebViewer accordingly.

  • Try using the ‘fullAPI’ option to enable more precise rendering and annotation handling.

  • Look into adjusting the zoom level programmatically after annotations are drawn to see if recalibrating the view helps maintain alignment.



Here are some resources that might help you:


Hopefully, this helps you solve your problem while you wait for a human to get back to you.

Hello @patrick.eiermann,

Thank you for posting on our forum.

Following your instructions and using your sample file, I was able to reproduce the issue on my end:

We have raised this issue and have added it to our backlog for our Product team to review. We do not have a firm timeline at this moment when the issue will be worked on, but we will be sure to reach out on this forum post if we have an update to provide.

Thank you for bringing this to our attention.

Best Regards,
Jacob Romano Carlsen
Web Development Support Engineer
Apryse Software Inc.