Testim Documentation

Welcome to the Testim documentation. You'll find comprehensive guides to help you get started quickly, example code snippets, and tips for being more productive. You will also find details about advanced features that allow you to customize Testim to fit your environment or special testing conditions. Don't worry, we'll support you if you get stuck. Let's jump right in!

Guides    Changelog


Understand how scroll step works

You probably noticed the scroll steps that appear in your tests.
Each time a scroll is made using the mouse wheel, we record a step and play it when the test is running.

In most cases it just works, in some cases, you may want to change it. So let's try to figure out how it works.

Scroll to element

Scroll to an element is the most popular scroll, this will be recorded when you scroll and interact with an element on your application.

In this example, we recorded a scroll to a "Book" button.

  • The x,y check boxes indicate which scroll is needed, in this example only vertical scroll was needed (Y axis).
  • The values in the text fields indicate the position of the chosen element after the scroll relative to the top left corner of the view-port.

This scroll will work even if the resolution changes, it is not an absolute scroll, it is relative to the element you are looking for. When you record, try placing the element in the middle of the screen, it will bring you a better result when the resolution changes.

Scroll on page / Scroll on element

"Scroll on page" step and "Scroll on element" step are absolute scrolls, they will be recorded when a scroll is made on the page but with no interaction with an element after scrolling.

The x,y values will be calculated according to the upper left corner of the page/element. e.g. in the above example, we will scroll to position 1600 relative to the top of the page.
Note: Checking the check boxes are not required in absolute scrolling, the scrolling is performed according to the values in the text boxes.

Update scroll steps##

There are some changes you can perform on scroll steps.

Change relative target element

  • Click the "Reassign" button located below the target element.
  • Select different element in the application you want to scroll to.

Change from absolute to relative

  • Select "Relative to Element" radio button.
  • Select element on your application you want to scroll to.

Change from relative to absolute

  • Select "Absolute" radio button.
  • The default values will be set to the location of the element on the page. You can change the x,y values to another location if needed.


  • To keep your tests as robust as possible, Testim will capture every scroll that will happen on the page, you may find that some scrolls are not needed in your flow, in which case you can easily delete them.
  • If you get the message "No app to choose an element from" this means that you must first run the test so you can select a component from within your application.

Mouse Wheel

Some applications implement advanced interactions using the mouse wheel (for example custom scroll components which do not use the native scroll bar or map applications).
In these cases, the recorded step will be a mouse wheel step, instead of a scroll step.

Updated 2 years ago


Understand how scroll step works

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.