# Troubleshooting DRAGEN analysis error UMI processing is enabled but QNAME does not have UMI section

DRAGEN can process data from whole genome and hybrid-capture assays with unique molecular identifiers (UMI). UMIs are molecular tags added to DNA fragments before amplification to determine the original input DNA molecule of the amplified fragments. UMIs help reduce errors and biases introduced by DNA damage such as deamination before library prep, PCR error, or sequencing errors.

If users encounter this error: **"UMI processing is enabled, but QNAME does not have UMI section error",** DRAGEN is complaining about missing UMI in the header of the FASTQ file input.

This error means the FASTQ file read name does not include the UMI sequence. However, if UMI option is enabled, DRAGEN expects the UMI in the header of FASTQ file:

The \*.fastq files need to have UMI barcode in 8th field of the read name (QNAME). See the following example:

@NS500561:434:H5LC2BGXJ:1:11101:10798:1359:**CACATGAACATTC** 1:N:0:TGGTACCTAA+AGTACTCATG

## For more information about the usage of UMI pipeline in DRAGEN, refer to [*Unique Molecular Identifiers*.](https://help.dragen.illumina.com/product-guide/dragen-v4.4/dragen-dna-pipeline/unique-molecular-identifiers)

To resolve this issue, users need to regenerate the FASTQ with appropriate settings to include UMI in the header of the FASTQ files. Specifically, users need to use the OverrideCycles setting using BCL Convert ( local tool or BCL Convert app).

![](/files/2okww61gxzJmg44bFkRC)

The OverrideCycles option tells BCL Convert the location of the UMI bases and how to handle each read. (eg, OverrideCycles, Y101;U20;I8;Y101)

Example how to set up the OverrideCycle option in the Sample Sheet can be found [here](https://knowledge.illumina.com/software/on-premises-software/software-on-premises-software-reference_material-list/000007337).

Using [Run Planning](https://basespace.illumina.com/run-planning/run-settings) (link required BaseSpace login) is recommended to generate a sample sheet for reanalysis to make sure that the required fields and formatting are correct.

\
\
\ <br>

|                                                                                                                                                                                                                                                                                                                                                                 |
| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| *For any feedback or questions regarding this article (Illumina Knowledge Article #8107), contact Illumina Technical Support* [*techsupport@illumina.com*](mailto:techsupport@illumina.com?subject=Question%2FFeedback%20Regarding%20Illumina%20Knowledge%20Article%20#000008107%20-%20Software%20\&body=Dear%20Illumina%20Technical%20Support,%0D%0A%0D%0A)*.* |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://knowledge.illumina.com/software/cloud-software/software-cloud-software-troubleshooting-list/000008107.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.