> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.boxhero.io/docs/resources/guides/zebra-tc21.md).

# ZEBRA TC21

***

{% hint style="warning" %}
**Note:** These steps use Zebra's [DataWedge app](https://www.zebra.com/us/en/software/mobile-computer-software/datawedge.html), which is pre-installed on all Zebra devices, so the same setup applies to other Zebra Android models as well.
{% endhint %}

## PDA Setup

{% stepper %}
{% step %}

### Open DataWedge

DataWedge comes pre-installed on every Zebra device. Search your apps for **"DataWedge"** and open it.

<figure><img src="/files/sjJYBAZAZonVtmkWS0gP" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### Create a Profile

A profile tells the scanner how to behave inside a specific app.

1. Tap the `...` menu in the top-right corner and select `New profile`.
2. Enter "BoxHero" as the name and tap `OK`.
3. Select the new `BoxHero` profile from the list.

<figure><img src="/files/bmQ6u4FanBthOOoMPhlu" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### Link the BoxHero App

1. Check `Profile enabled`.
2. Tap `Associated apps`.
3. Tap the `...` menu in the top-right corner and select `New app/activity`.
4. Select `com.bgpworks.boxhero` from the list.
5. Select `*` to apply the profile to all activities within the app.

<figure><img src="/files/dZowcHBc1lDOs6ZYE8qI" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/hXLjP5kQl4n4niT1W2AR" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### Configure Output

Press the back button at the bottom of the device to return to the main **profile screen**, then scroll down to the `Keystroke output` section.

For BoxHero to read scanned barcodes, all three of these settings must be turned on:

1. Check `Enabled`.
2. Open `Key event options` and check `Send Characters as Events`.
3. Open `Basic data formatting` and check `Enable`, `Send data`, and `Send ENTER key`.

{% endstep %}

{% step %}

### Test the Setup

Confirm everything works from inside the BoxHero app:

Go to <mark style="color:$primary;">`Stock In`</mark>, select <mark style="color:$primary;">`Scan Barcode`</mark>, set the scan method to <mark style="color:$primary;">`External Barcode Scanner`</mark>, then scan an item.

{% content-ref url="/pages/BQ8pCbCN9fZJ2y48AcU0" %}
[Barcode Scanning](/docs/key-features/scan-barcode.md)
{% endcontent-ref %}

{% endstep %}
{% endstepper %}

## Troubleshooting

**Barcodes aren't scanning?** Go back through each step above and check for anything that was skipped or set incorrectly. If the problem continues, try closing the BoxHero app and reopening it.