Troubleshooting

How to troubleshoot an image-search upload that gets stuck

Check whether the file is still uploading or the service is processing it. Repeated submissions can create duplicate jobs without resolving the underlying problem.

Start with the file

Confirm that it opens locally, fits the stated size limit and uses a supported format. A file stored only in a cloud library may need downloading before a browser can send it reliably.

Test in a controlled order

  1. Wait for the current request's status or timeout.
  2. Check your connection with an ordinary page load.
  3. Try a small, non-sensitive permitted sample.
  4. Record any visible error before retrying.

If the sample works but the original does not, inspect the original's encoding and dimensions. If both fail, the problem may concern the browser or service rather than the photograph.

Keep privacy in the retry

Do not send the same private image to multiple unrelated providers as a diagnostic shortcut. Review the service's help and cleanup options. In Facehunch, upload success and a provider result are separate stages, and restricted test coverage remains unchanged by a retry.

Continue with image-search troubleshooting.

Published by Facehunch with AI assistance. How we use sources and maintain these guides.
KEEP EXPLORING

Related guides

FROM READING TO EXPLORING

See how a photo search comes together.

Try the fictional example, or run a consented API test. Paid searches are disabled.

Open Facehunch