Troubleshooting
Recover from common account, upload, scene, AI, and export problems without losing project work.
I cannot sign in or find my project
- Check the email address and sign-in method used to create the account.
- Complete email verification if prompted. Use the password-reset action if you cannot remember the password.
- If you were invited, sign in with the invited email address. Accept the invitation, then select that organization.
- Check project access with an organization administrator. A Viewer can see project details but cannot open the interactive editor.
- Check archived projects and project preparation status before creating another project.
The editor or scan will not load
- Check that the project environment is active and ready.
- Check the internet connection and any visible upload/conversion error.
- Use a current browser with hardware acceleration enabled. Close other GPU-heavy tabs if the scene is large.
- Confirm the file is a supported geometric format. A splat PLY, raw photos, or a proprietary project archive may not be a usable scan.
- Save a copy of important work before trying a small known-good scan or a demo in the project.
Do not upload the same large file again if conversion or display is failing. Record the exact error and filename. A file can be below the upload limit and still be too demanding to view smoothly.
The scene is empty, clipped, or transparent
- Check Scene source.
- Use View → Fit scene.
- Enable Points or Mesh, and CAD when you expect modeled geometry.
- Clear focus and check object visibility.
- Check whether you are inside or behind the object, or viewing a different virtual camera.
Point clouds have gaps between points. A capture app can look more solid because it shows a mesh with textures. The number of displayed points can also change while a large cloud loads. Neither effect means that source points were deleted.
Measurements look wrong
Check the source units, model import scale, and endpoints. Confirm whether you need a horizontal gap or a direct 3D distance. Equipment height also needs a reference level; a Z coordinate alone is not a height measurement. Compare a known distance. Fix any scale error before using more measurements.
The AI is disconnected, stopped, or wrong
- Disconnected: check the editor’s connection state and network. Keep the draft; reconnect before sending again.
- Stopped after closing the browser: Free tasks need the editor open. Reopen the same scene/conversation and send a new continuation request.
- Tool error: open Details, read the actual failure, and request a smaller or corrected operation.
- Wrong object: clarify its location, attach an annotated view, or mark a region before asking again.
- Geometry looks right but measures incorrectly: show it with the source from opposite views. Ask the agent to correct it using the scan points.
- Stop did not undo changes: this is expected. Inspect what completed before requesting a correction or restoring a saved milestone.
Voice input is unavailable
Allow microphone access and check which microphone the browser is using. Use the secure hosted app or an allowed local address. Select Finish after recording and wait for the text. Check numbers and units, then select Send. Recordings can exceed the two-minute or file-size limit.
A file or conversation appears missing
- Confirm the selected organization and project.
- Check Scene source and search/refresh the conversation list.
- In Files, check both Uploads and Outputs, subfolders, and the current filter.
- If conversations are missing after an earlier Pro upgrade, contact support to restore the available history. Existing Pro conversations are preserved.
- Check whether an external AI client saved the report in its own conversation or local folder rather than the CADground project.
Do not reset or delete the project to recover missing history. Record what is missing and when it was last visible.
A download or export is wrong
For a report, check that the agent created the file and that you downloaded the latest version. For geometry, check the selected scene and export format. Set the correct units when opening STL. Selecting STEP does not reconstruct a raw point cloud.
If export fails, save the error message and inspect the affected geometry. Do not omit failed parts without explanation. State which parts were exported and which still need work.
Send useful details to support
Email support@cadground.ai with:
- Your account email and the relevant organization/project.
- The scene/source filename, format, approximate size, and units if relevant.
- The steps that led to the failure and what you expected.
- The exact error, approximate time, browser/client version, and a screenshot if useful.
- Whether the problem repeats with a small demo or only with the specific source.
Do not include passwords, OAuth tokens, session cookies, or provider API keys. For external clients, also use the MCP-specific checklist.