> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firstresonance.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshoot scanning

> Fix a handheld scan that doesn't register, camera errors, and scans ION doesn't recognize or refuses.

For setup, see [Set up scanners and cameras](/build-hardware/labels-and-scanning/scanning/set-up-scanners-and-cameras).

## Troubleshooting

<AccordionGroup>
  <Accordion title="A handheld scan does nothing">
    **Cause:** ION ignores keystrokes typed into a text field, so a scan with the cursor in a field types into the field. ION also ignores a barcode shorter than 10 characters, and a scan when the ION tab isn't focused.

    **Fix:** Click outside the field, then scan again. On a device with a camera, you can enter a shorter barcode in the camera dialog's **Enter barcode** field, which has no minimum length.
  </Accordion>

  <Accordion title="Scan with camera isn't in the sidebar">
    **Cause:** The item appears only when the browser lists a camera on the device. In the phone layout, there's no sidebar.

    **Fix:** Connect or enable a camera. On a phone, use the home screen's camera. See [Scan on a phone](/build-hardware/labels-and-scanning/scanning/scan-on-a-phone).
  </Accordion>

  <Accordion title="Camera access was blocked">
    **Cause:** The browser hasn't given ION permission to use the camera.

    **Fix:** Allow camera access for ION in your browser, then click **Try again**.
  </Accordion>

  <Accordion title="No camera was found on this device">
    **Cause:** The browser couldn't open a camera.

    **Fix:** Connect or enable a camera, then click **Try again**.
  </Accordion>

  <Accordion title="The camera is already in use by another application">
    **Cause:** Another app holds the camera.

    **Fix:** Close the other app's camera, then click **Try again**. If the device has another camera, ION offers **Try another camera**.
  </Accordion>

  <Accordion title="Not recognized, or no entities found on a phone">
    **Cause:** The barcode doesn't match any ION record.

    **Fix:** Check that you scanned an ION label for an existing record. For a barcode from a supplier or another system, an admin can map its format. See [Scan barcodes from other systems](/build-hardware/labels-and-scanning/scanning/scan-barcodes-from-other-systems).
  </Accordion>

  <Accordion title="Unrecognized entity type on a phone">
    **Cause:** The phone layout doesn't recognize run labels.

    **Fix:** Scan the run's label on a computer or tablet.
  </Accordion>

  <Accordion title="Scanning unavailable here">
    **Cause:** In the phone layout, you can scan only on the home screen, the kit queue and its kits, a location's page, and a pick run.

    **Fix:** Go back to the home screen and scan there.
  </Accordion>

  <Accordion title="A part scanned on a run moved instead of installing">
    **Cause:** With a handheld scanner, a part scan on a run goes to the current selection, such as a selected location, when there is one.

    **Fix:** Close the scan tray to clear the selection, then scan the part again.
  </Accordion>

  <Accordion title="Cannot install: no run step is active">
    **Cause:** You scanned a part on a run with no run step selected.

    **Fix:** Select the run step, then scan the part again.
  </Accordion>

  <Accordion title="Confirm or cancel the question in the camera dialog first">
    **Cause:** The camera dialog is waiting for an answer to its question.

    **Fix:** Answer the question in the dialog, then scan again.
  </Accordion>
</AccordionGroup>


## Related topics

- [Set up scanners and cameras](/build-hardware/labels-and-scanning/scanning/set-up-scanners-and-cameras.md)
- [Print a label](/build-hardware/labels-and-scanning/printing.md)
- [Configure Zebra Browser Print](/build-hardware/labels-and-scanning/printing/configuring-printing-in-ion.md)
- [Require barcode scanning for installations](/administration/production-settings/require-barcode-scanning-for-installations.md)
- [Custom analytics with the Data Connector](/automate-with-ion/analytics-and-dashboards.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.