Skip to main content

Image-based Testing Troubleshooting

Image-based tests can fail when the visual appearance of the application or the execution environment changes. Differences in scaling, resolution, theme, fonts, or dynamic screen content can affect how reliably Ranorex finds an image during playback. This article describes common symptoms, explains the most likely causes, and provides practical fixes to improve the stability of image-based recognition.

Symptoms

  • Image not found on playback
  • Click/type happens in the wrong place
  • Works on one machine but fails on another

Causes and fixes

Causes Fixes
DPI/scaling/resolution differences
  • Standardize display scaling across execution machines when possible.
  • Capture images that remain recognizable with small scaling differences.
Theme/color/font changes
  • Re-capture images under the same theme used in execution.
  • Prefer unique shapes/icons over text-heavy targets.
Dynamic UI
  • Reduce the captured region to avoid animated/dynamic content.
  • Capture a more stable anchor image and navigate relative to it.

When to switch back to UI object recognition

If the element can be identified as a UI object, object-based recognition is usually more robust in the long term. 

 

Related articles

Image Editor
Use the built-in image editor.
UI Elements Identification
Understand how Ranorex identifies UI elements.
Was this article helpful?
Powered by Zendesk