> For the complete documentation index, see [llms.txt](https://knowledge.illumina.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledge.illumina.com/software/cloud-software/software-cloud-software-troubleshooting-list/000008107.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.