Troubleshooting
What to check first, ordered by how often each turns out to be the cause.
I cannot see a module
Almost always licensing or permissions rather than a fault.
- Is it on Home? If not, you do not have it.
- Ask your administrator whether you hold a permission group that includes it.
- Check whether a logical group is narrowing your view.
A colleague seeing something you cannot is normal, not evidence of a fault.
I could see this data yesterday and cannot today
In this order:
- Logical group membership. Were you added to a group, or was a group's contents narrowed? This is by far the most common cause, and nothing tells you it has happened. See Group Members.
- Permission groups. Has a group been changed or removed?
- The period. Does the data exist in the range you are looking at? Retention may have passed.
A query returns nothing
Usually one filter too many. Remove the most recently added and work back — filters only ever narrow, so an empty result is over-filtering, not a fault.
Then check the date range, which removes more than any filter and is the easiest thing to get wrong. See Date and Time Ranges.
Video will not play
| Symptom | Check |
|---|---|
| Stills instead of video | You are in a browser — video needs the desktop client |
| Blank or black tiles | Video Rendering Settings |
| Video over panels that should be on top | Rendering mode — try Composite (WGC) |
| Nothing at all for one camera | Camera or recorder; check whether others on the same recorder work |
| Nothing for a period | Retention, or the recorder was not recording |
An export failed
Retry once — transient failures are common and clear on their own. If it fails again:
- The period may be outside retention
- The recorder may be unavailable
- The period may be too long; shorten it and retry
See Export Status and Downloads.
I am not getting alerts
- Are alerts muted? Check the title bar — see Muting Alerts.
- Are popups turned off in your alert preferences? Alerts may be arriving in the tray quietly.
- Is the tag that should raise them configured to alert? See Face Tags.
Email alerts or reports are not arriving
- Is there a valid address on the user's profile? A missing address delivers nothing, silently.
- Is the mail relay configured and tested?
- Check the spam folder, particularly for a newly configured sender.
Ace is unavailable
- It says so rather than failing silently — read the message.
- Administrators: check provider health under AI Configuration.
- An allowance may have been reached, which is a deliberate limit rather than a fault. See AI Usage and Analytics.
The assistant will not answer about something
Usually a boundary rather than a fault. Can you reach the same data through the ordinary views? If not, the assistant cannot either — it sees exactly what you see. See What Ace Can and Cannot See.
A dashboard has stopped showing data
- A saved query was edited or deleted. Widgets draw on queries; changing one changes every dashboard using it.
- The query has a fixed date range, so it is reporting a historical period forever. Use a relative period.
- The viewer lacks permission for the underlying data — it works for you and not for them.
See Sharing, Locking and Importing.
I keep being signed out
The idle timeout is set per user group, and watching video does not count as activity. For a permanent display, ask about a group with no timeout. See Session Timeout and Signing Out.
My sign-in code is not accepted
From 11.0.10, for accounts with multi-factor sign-in turned on. In this order:
- Is it the right entry, and a fresh code? Read the eConnect entry in your authenticator app. Each code works once, so wait for the next rather than retyping one you have used.
- Is every code refused? Then a clock is wrong — codes are worked out from the current time. Set your phone to take its time automatically; if that does not fix it, the server's time is out and your administrator needs to know, because it affects everybody using codes.
- Does it say Too many failed sign-in attempts? Ten wrong codes in a row pause code entry for your account for fifteen minutes. Wait it out, then use a fresh code.
- Are you in the older Windows client? It has no code prompt: type your password followed immediately by the code, with no space. See The older Windows client.
No phone at all? Use a recovery code — see If you lose your phone.
My emailed sign-in code does not arrive
From 11.0.10, for accounts with email codes.
- Check the spam folder, and that the address in your profile is right.
- Wait before asking again. eConnect sends sign-in codes to one address at most once a minute, three times in five minutes and five times in fifteen minutes, and a code over those limits is simply not sent. Send a new code appears sixty seconds after each code.
- Use a recovery code, or your authenticator app if you have one, meanwhile.
- Nobody's codes arrive? Then email from eConnect is not getting through. Administrators: test the mail relay.
I am asked to set up multi-factor sign-in
Your user group requires it (from 11.0.10). During the grace period you are only reminded; once it is over you have to set it up to sign in — Set up multi-factor sign-in to continue. Have your phone, with an authenticator app, to hand. See When your organisation requires it.
In the older Windows client the same situation shows as Set up multi-factor sign-in in the eConnect web application before signing in here. Sign in once in a browser or the desktop client to set it up.
Use a passkey is missing, or the passkey does not work
- Are you in a browser? Passkeys are not used in the desktop client or the older Windows client.
- Is this the right address? A passkey works only at your server's own
httpsaddress. A line under the code field names the address where it works. - Does every attempt say The passkey was not used? The site's certificate may not be one your browser trusts — tell your administrator.
- Does your profile say the passkey no longer works? The server's address changed. Remove it and add it again.
A code always works instead. More in If a passkey does not work.
Forgot password? is missing, or no reset email arrives
- Is it switched on? Forgot password? appears only where an administrator has turned on password reset by email and the server can send email. Otherwise ask your administrator for a new password.
- Wait before asking again. Only a few reset emails go to one address or account per hour, and extra requests are dropped silently.
- Is it a directory account? eConnect cannot reset those; the email says so. Ask your IT team.
- Check the spam folder, and that your profile has the right address.
I cannot switch to another user group
If switching says This group requires multi-factor sign-in. Turn it on in your profile, then sign in again., the group you are switching to requires a second step your current sign-in did not use. Set up multi-factor sign-in if you have not, sign out, and sign in again with a method that group allows. See Switching user group.
A pop-out will not open in the browser
The browser is probably blocking the popup. Allow popups for your eConnect server. Installing eConnect as an app also removes the address bar from pop-outs — see Using eConnect in a Browser.
Before raising a support case
Gather:
- What you did, and what you expected
- The exact time it happened, and your time zone
- Whether a colleague can reproduce it
- Whether it happens in both the desktop client and the browser
The last two are the most useful and the most often missing. A problem one person has and another does not is usually permissions or scope, and knowing that saves everybody a day.