Troubleshooting
Upload Failures
After capturing a screenshot, recording, or replay, Crosscheck saves the files to your workspace. This page covers the most common upload failures and how to resolve them.
Common Upload Failures
| Issue | Cause | Resolution |
|---|---|---|
| Network timeout | Slow or unstable internet connection | Check your network connection and try again. Use the retry button in the extension to re-attempt the upload. |
| Storage limit reached | Workspace storage quota is full | Delete old captures to free up space. |
| Upload authorization expired | The upload authorization expired before the upload completed | This can happen with very large files on slow connections. Try the upload again using the retry button. |
| Large file timeout | Video recording is too large for the upload to complete within the timeout window | Trim the recording to reduce file size before uploading. Long recordings produce large files that take longer to upload. |
Resolving Network Timeouts
1
Check Your Connection
Ensure you have a stable internet connection. Try loading a webpage to confirm connectivity.
2
Retry the Upload
When an upload fails, a retry button appears in the extension. Click it to attempt the upload again.
4
Check Firewall or VPN
Corporate firewalls or VPN configurations may block uploads. Contact your network administrator if uploads consistently fail on your corporate network.
Resolving Storage Limit Issues
1
Check Current Usage
Check your current storage usage in the Crosscheck dashboard.
2
Free Up Space
Delete captures you no longer need to free up space.
3
Contact Support if Needed
If you continue to hit storage limits after cleanup, reach out to us at support@crosscheck.live for assistance.
Manual Retry
When an upload fails, the extension preserves the capture data and provides a retry button. Click retry to re-attempt the upload without needing to recapture.
Reducing Upload Size
Large file uploads are more likely to fail on slow connections. To reduce upload size:
- Trim recordings: Use the trim feature after recording to keep only the portion that demonstrates the bug.
- Use instant replay instead: Instant replay captures are significantly smaller than video recordings because they store DOM mutations as JSON rather than pixel data.
- Capture specific moments: Instead of recording a long session, capture targeted screenshots or short recordings of the specific behavior.
Do Not Close the Tab During Upload
Closing the browser tab or the extension popup while an upload is in progress may interrupt the upload. Keep the tab open until the upload completes and the capture appears in your dashboard.
Last updated: March 2026