What does TESTOMATIO_SHARED_RUN_TIMEOUT do?

It’s used when you run tests in parallel and want all those parallel jobs to report into a single run in Testomat.io, instead of creating a separate run each.

To group them, you give the jobs a shared title and set TESTOMATIO_SHARED_RUN=1. Testomat.io then collects jobs with that title into one run, but only for a limited time window. By default, that window is 20 minutes. If your parallel jobs take longer than that to all finish, the later ones would start a new run instead of joining the first.

TESTOMATIO_SHARED_RUN_TIMEOUT extends that window. You give it a value in minutes, so the jobs keep reporting into the same run for as long as you need.

Where to set it

This is a reporter setting, so you set it in your CI or terminal where the tests run, together with your other reporter variables. There is no field for it in the Testomat.io interface.

Example, extending the window to 2 hours (120 minutes):

TESTOMATIO={API_KEY} TESTOMATIO_TITLE="report for commit ${GIT_COMMIT}" TESTOMATIO_SHARED_RUN=1 TESTOMATIO_SHARED_RUN_TIMEOUT=120 <your run command>

This is not the same as the Automated runs freeze timeout in project settings. That one is a setting in the interface.

Related documentation

See the Playwright integration guide, section “Extending Shared Run Timeout”: https://docs.testomat.io/tutorials/playwright/