# How to Fix Zebra Label Template Deployment Failures?

Use this guide when a template deployment fails, a template does not appear on the printer, an old template remains in place, the wrong template is printed, or a template replacement removes an unexpected file.

Supported File Formats
----------------------

Hexnode UEM supports the following Zebra Printer template and resource file formats:

File FormatSupported UseValidation After Deployment`.zpl`Zebra Programming Language template or printer instruction file.Confirm that the template is available and produces the expected label.`.nrd`Supported Zebra Printer resource file.Confirm presence in the relevant printer template or resource list.`.txt`Text-based template or printer instruction file.Confirm the intended printer behavior.`.lbl`Label-template file.Print a test label.`.zbi`Zebra BASIC Interpreter file.Confirm expected script or printer behavior.How Deploy Templates Works
--------------------------

To deploy a Zebra Printer template, navigate to:

`Manage > Devices > [Select Zebra Printer] > Actions > Deployments > Deploy Templates`

Select one of the following sources:

- **Upload file**
- **Hexnode repository**

Administrators can select **Delete existing files from device** when an existing file with the same name and format must be replaced.

**Result:** Hexnode UEM sends the selected file to the target Zebra Printer.

### Before You Deploy a Template

Confirm the following pre-checks prior to initiation:

- The printer is enrolled, powered on, and online.
- The selected file uses a supported format (`.zpl`, `.nrd`, `.txt`, `.lbl`, `.zbi`).
- The selected printer is the intended deployment target.
- The file source is accessible and the file name/extension are correct.
- The template was tested on a representative printer model.
- The administrator understands whether the existing printer file should be replaced.

> **Warning:** The **Delete existing files from device** option removes an existing printer file *only* when the existing file has the same name and format as the replacement file. Verify both values before deployment.

Troubleshoot File-Format and File-Source Issues
-----------------------------------------------

A deployment can fail when the selected file format is unsupported, the file cannot be retrieved from the source, or the file lacks valid printer instructions.

- Confirm that the file extension is strictly `.zpl`, `.nrd`, `.txt`, `.lbl`, or `.zbi`.
- Confirm that the uploaded file is complete, valid, and uncorrupted.
- Confirm that the selected Hexnode repository file is the correct version.
- Confirm that the target printer model supports the file’s embedded commands.
- Confirm that the file has not been manually renamed with an invalid extension.

Troubleshoot Missing or Outdated Templates
------------------------------------------

If the deployment action reports success in the console but the template is missing from the printer:

1. **Verify Target Device:** Confirm that the deployment command was issued to the correct Zebra Printer.
2. **Review Action History:** Check the status in **Action History** to confirm execution status.
3. **Verify File Naming:** Ensure the file name and extension on the endpoint match the intended template name.
4. **Inspect Printer Resources:** Review the printer’s internal template/resource inventory list.
5. **Perform Test Print:** Print a test label to confirm if the output matches the newly deployed template.

Troubleshoot Replacement-File Behavior
--------------------------------------

If an existing template was **not replaced**:

- Confirm that the replacement file shares the exact same file name as the existing printer file.
- Confirm that the replacement file uses the same file format/extension.
- Confirm that **Delete existing files from device** was checked during the deployment action.

If an existing template was **removed unexpectedly**:

- Check whether **Delete existing files from device** was accidentally enabled for a matching file name.
- Compare the deleted file’s name and extension with the newly deployed file.
- Re-deploy the approved template if the original file was cleared from device storage.

Troubleshooting Table
---------------------

SymptomProbable CauseResolutionValidationDeploy Templates action failsPrinter is offline, file source is unavailable, or file is invalid.Confirm printer connectivity and reselect a supported file.Action History reports success.Template does not appear on printerDeployment did not complete or file was sent to the wrong printer.Verify target selection and retry the action.Template appears in printer template list.Existing template was not replacedFile name or extension differs from existing printer file.Verify matching file name and format; enable replacement option if required.Old file is removed and new file is present.Existing template was removed unexpectedlyDelete option was enabled for a matching file name and type.Re-deploy the correct approved template.Expected file list is restored.Printed labels are incorrect after deploymentWrong template version or printer settings differ from baseline.Deploy the approved template and validate printer configuration.Print a test label and compare output.Validate a Deployed Template
----------------------------

1. **Action History:** Review the deployment status under **Action History** to confirm Hexnode UEM completed the request.
2. **Printer Verification:** Check the template inventory directly on the Zebra Printer display/web interface to verify file existence.
3. **Test Print:** Print a test label using the newly deployed template to confirm content alignment, barcode readability, and proper media dimensions.