Screen Browser
Documentation

Troubleshooting

How a run ends, what the common failures mean and what to do about them.

How a run ends

The run page says Meaning Charged?
Completed the video is in your library yes, for its length
Failed a step could not be done, the login gate never held, or something on our side broke no
Canceled you stopped it no
Paused the balance ran out mid-run; top up and resume, only the recording starts over only the finished part, on resume

A run that hit a problem on our side is relaunched by us at no cost to you. Videos are capped at five minutes and a run at thirty minutes of wall clock.

Why a run failed

A failed run costs nothing and its page names the line, the reason and the last screenshot. The most common reasons:

The run page says What it means What to do
Login gate never held the sign-in ran, but the URL fragment or text that proves the login never appeared check what the app shows after signing in; for single-page apps use text only a signed-in user sees; check the demo user's password
Login gate missing the project has no gate set one on the project's Connection tab
A step could not be done (with the line) the element the step names was not on the page, or a timeout run a free check to see the page at that step; name the element the way it is shown; add Wait for … before it; if it only sometimes appears, make it If visible, click …
Attestation required the hostname has not been attested attest it on the project page
Insufficient credits the balance is below one credit top up, then start or resume
Check limit reached today's free checks are used up record instead; a failed recording is free
Video too long the guide would pass five minutes split it into two guides
Sensitive content detected a guide types what looks like a real secret put it in a variable
Failed on our side a crash, a page that never loaded, a provider outage we relaunch these once automatically; if it fails again, click Send failure report and we look at it

Things that look wrong in the video

  • The page is empty or missing data. A host the frontend calls is not in the project's allowed hosts. Add it.
  • The effect I asked for is not there. It is outside your plan; the run activity says so. Pro and above include every effect.
  • A highlight is on the wrong thing. Pin the target in the editor: the step's target field takes the exact text, label or role.
  • The narration is in the wrong language. The project's language is on the project's Voice tab.

Asking for help

Use the contact form with the run link from the run page. Send failure report on a failed run attaches the evidence for you.