# unable to use .qza files

**URL:** <https://help.galaxyproject.org/t/unable-to-use-qza-files/13361>\
**Category:** Uncategorized\
**Tags:** qiime2, qiime2\_core\_\_tools\_\_import\
**Created:** [September 2, 2024, 10:09am UTC](https://help.galaxyproject.org/t/unable-to-use-qza-files/13361 "2024-09-02T10:09:53Z")\
**Posts on this page:** 12\
**Page:** 1

<div class="post-metadata">

**Author:** ![MEENU\_GHAI](https://sea2.discourse-cdn.com/flex020/user_avatar/help.galaxyproject.org/meenu_ghai/32/6007_2.png) [@MEENU\_GHAI](https://help.galaxyproject.org/u/MEENU_GHAI)\
**Post date:** [September 2, 2024, 10:09am UTC](https://help.galaxyproject.org/t/unable-to-use-qza-files/13361/1 "2024-09-02T10:09:53Z")

</div>

This is a binary (or unknown to Galaxy) dataset of size 62.5 KB. Preview is not implemented for this filetype. Displaying as ASCII text  
[Download](https://usegalaxy.org/datasets/f9cad7b01a4721358636f0aeeb390117/display?to_ext=qza)

---

<div class="post-metadata">

**Author:** ![jennaj](https://sea2.discourse-cdn.com/flex020/user_avatar/help.galaxyproject.org/jennaj/32/27_2.png) [@jennaj](https://help.galaxyproject.org/u/jennaj)\
**Post date:** [September 3, 2024, 6:01pm UTC](https://help.galaxyproject.org/t/unable-to-use-qza-files/13361/2 "2024-09-03T18:01:43Z")

</div>

Hi @MEENU_GHAI

Correct, the **qza** and or **qzv** binary datatypes are not available in an uncompressed plain-text Galaxy “peek view” version. Just the metadata is exposed for now. This was likely on purpose, and I don’t know if it is possible to do something different. These tools were “wrapped” for Galaxy by the original authors, so asking them about future plans is where to start. I’m guessing that many people would find more ways to review these data useful!

I can let you know that the Galaxy implementation has some extra metadata that may be helpful. Think of this as another “level” to a QIMME2 datatype: similar to how a BED file can have 3 columns, or 4, or 6, or 12 and some tools will be picky about which is expects to work with.

**WHERE to review QIIME2 data in Galaxy**

Reviewing in these places can provide some context about why or why not a particular dataset (artifact) is available to a tool.

- Review the “Galaxy format dataype”. This is defined as **qza** for QIIME2 artifacts and **qzv** for QIIME2 visualizations.
- Next, click into the pencil-icon for any, and you’ll see a type of “sub-format” also defined for **qza** datasets.
  - This is “detected” from the artifact content, can’t be modified directly by a user, and specifies what type of artifact you have.
  - These types were defined by the QIIME2 authors – and should match what is expected when using the tools outside of Galaxy, too.

- **How it works:** Galaxy tool forms are performing a somewhat unique “double filter” when selecting an input dataset:
  - the **Galaxy format datatype** needs to be **qza** or **qzv**
  - and, the **QIIME2 format** needs to match what the tool is expecting
  - then if both are true: a dataset in the history will be listed as potential input

**HOW to review QIIME2 data in Galaxy**

The current options to query, explore, and compute with **qza** and **qzv** compressed artifacts in Galaxy are the same as used on the command line. Meaning, these are the exact same tools, and have the same names and operations. The guides for usage are included in these places:

- [https://qiime2.org/](https://qiime2.org/)

and the publication

- Reproducible, interactive, scalable and extensible microbiome data science using QIIME 2. _Nature Biotechnology_, _37_(8), 852–857. [Reproducible, interactive, scalable and extensible microbiome data science using QIIME 2 | Nature Biotechnology](https://doi.org/10.1038/s41587-019-0209-9)

* * *

There isn’t a GTN Galaxy-specific tutorial (yet) but that may be developed in the future. 🙂

If you have a more specific issue, you are still welcome to post more details. See the banner at this forum for how to get help with a tool error if that is what is going on. Thanks!

---

<div class="post-metadata">

**Author:** ![colinbrislawn](https://sea2.discourse-cdn.com/flex020/user_avatar/help.galaxyproject.org/colinbrislawn/32/5643_2.png) [@colinbrislawn](https://help.galaxyproject.org/u/colinbrislawn)\
**Post date:** [September 3, 2024, 7:04pm UTC](https://help.galaxyproject.org/t/unable-to-use-qza-files/13361/3 "2024-09-03T19:04:16Z")

</div>

As another option, you can download the .qza and .qzv files and view them with  
[https://view.qiime2.org/](https://view.qiime2.org/)

This will let you view metadata, provenance, and the visualization within a .qzv file.

All Qiime2 artifacts are simply zip files, you can also extract them after downloading.

---

<div class="post-metadata">

**Author:** ![MEENU\_GHAI](https://sea2.discourse-cdn.com/flex020/user_avatar/help.galaxyproject.org/meenu_ghai/32/6007_2.png) [@MEENU\_GHAI](https://help.galaxyproject.org/u/MEENU_GHAI)\
**Post date:** [September 5, 2024, 10:56am UTC](https://help.galaxyproject.org/t/unable-to-use-qza-files/13361/4 "2024-09-05T10:56:43Z")

</div>

Hi Jennifer,

Thanks.

This is what I see when I open a .qza file in galaxy. How can I go past this issue.

Kind regards

Meenu

 ![](https://us1.discourse-cdn.com/flex020/uploads/galaxy/original/2X/d/d6269ccb5b1d4c7beaf640d9d5d7c492327d4cb6.png)

---

<div class="post-metadata">

**Author:** ![jennaj](https://sea2.discourse-cdn.com/flex020/user_avatar/help.galaxyproject.org/jennaj/32/27_2.png) [@jennaj](https://help.galaxyproject.org/u/jennaj)\
**Post date:** [September 5, 2024, 6:56pm UTC](https://help.galaxyproject.org/t/unable-to-use-qza-files/13361/5 "2024-09-05T18:56:54Z")

</div>

Hi @MEENU_GHAI The file is compressed in Galaxy, and not in plain text.

To view it in plain text, you can try what @colinbrislawn is suggesting.

---

<div class="post-metadata">

**Author:** ![MEENU\_GHAI](https://sea2.discourse-cdn.com/flex020/user_avatar/help.galaxyproject.org/meenu_ghai/32/6007_2.png) [@MEENU\_GHAI](https://help.galaxyproject.org/u/MEENU_GHAI)\
**Post date:** [September 6, 2024, 9:16am UTC](https://help.galaxyproject.org/t/unable-to-use-qza-files/13361/6 "2024-09-06T09:16:45Z")

</div>

Thanks. As i am unable to use these .qza files in Galaxy, can i use.tsv metadata files to continue with alpha diversity and beta diversity analysis

---

<div class="post-metadata">

**Author:** ![MEENU\_GHAI](https://sea2.discourse-cdn.com/flex020/user_avatar/help.galaxyproject.org/meenu_ghai/32/6007_2.png) [@MEENU\_GHAI](https://help.galaxyproject.org/u/MEENU_GHAI)\
**Post date:** [September 6, 2024, 9:18am UTC](https://help.galaxyproject.org/t/unable-to-use-qza-files/13361/7 "2024-09-06T09:18:59Z")

</div>

Thanks Colin. i can view the .qzv files @ [https://view.qiime2.org/](https://view.qiime2.org/) , however, i cannot use these files in galaxy to calculate alpha diversity, beta diversity etc of my samples

---

<div class="post-metadata">

**Author:** ![colinbrislawn](https://sea2.discourse-cdn.com/flex020/user_avatar/help.galaxyproject.org/colinbrislawn/32/5643_2.png) [@colinbrislawn](https://help.galaxyproject.org/u/colinbrislawn)\
**Post date:** [September 6, 2024, 3:22pm UTC](https://help.galaxyproject.org/t/unable-to-use-qza-files/13361/8 "2024-09-06T15:22:43Z")

</div>

Okay! I’m glad you were able to open the files and see what’s inside!

Let’s see if we can get Galaxy working for you. Let’s start with these two questions:

Are you following a tutorial?  
When you try to run an alpha diversity command, what does it show you?

---

<div class="post-metadata">

**Author:** ![MEENU\_GHAI](https://sea2.discourse-cdn.com/flex020/user_avatar/help.galaxyproject.org/meenu_ghai/32/6007_2.png) [@MEENU\_GHAI](https://help.galaxyproject.org/u/MEENU_GHAI)\
**Post date:** [September 6, 2024, 7:55pm UTC](https://help.galaxyproject.org/t/unable-to-use-qza-files/13361/9 "2024-09-06T19:55:29Z")

</div>

I am not following a specific tutorial. The .qzv files are not accepted for alpha diversity analysis and the .qza do not seem to be in the right format.

 ![](https://us1.discourse-cdn.com/flex020/uploads/galaxy/original/2X/a/a13e186936c001770118d42de878d0ea9490cec8.png)

---

<div class="post-metadata">

**Author:** ![MEENU\_GHAI](https://sea2.discourse-cdn.com/flex020/user_avatar/help.galaxyproject.org/meenu_ghai/32/6007_2.png) [@MEENU\_GHAI](https://help.galaxyproject.org/u/MEENU_GHAI)\
**Post date:** [September 6, 2024, 9:11pm UTC](https://help.galaxyproject.org/t/unable-to-use-qza-files/13361/10 "2024-09-06T21:11:49Z")

</div>

Hi Colin,

I am also trying to import fastq files into galaxy however, receive the following error

 ![](https://us1.discourse-cdn.com/flex020/uploads/galaxy/original/2X/1/1da1923d6c4a177b66e761d61081664a37b80c9b.png)

---

<div class="post-metadata">

**Author:** ![MEENU\_GHAI](https://sea2.discourse-cdn.com/flex020/user_avatar/help.galaxyproject.org/meenu_ghai/32/6007_2.png) [@MEENU\_GHAI](https://help.galaxyproject.org/u/MEENU_GHAI)\
**Post date:** [September 8, 2024, 5:23am UTC](https://help.galaxyproject.org/t/unable-to-use-qza-files/13361/11 "2024-09-08T05:23:05Z")

</div>

Hi Colin,

I have saved fastq files as fastq.gz and am exporting them into qiime2 artifact. I have few questions:

---

<div class="post-metadata">

**Author:** ![colinbrislawn](https://sea2.discourse-cdn.com/flex020/user_avatar/help.galaxyproject.org/colinbrislawn/32/5643_2.png) [@colinbrislawn](https://help.galaxyproject.org/u/colinbrislawn)\
**Post date:** [September 9, 2024, 8:40pm UTC](https://help.galaxyproject.org/t/unable-to-use-qza-files/13361/12 "2024-09-09T20:40:03Z")

</div>

Try this tutorial: [QIIME 2 Cancer Microbiome Intervention Tutorial — QIIME 2 Cancer Microbiome Intervention Tutorial](https://docs.qiime2.org/jupyterbooks/cancer-microbiome-intervention-tutorial/)

There are many small details that it covers. For example, .qzv files are visualizations and are not usually inputs… There should be .qza files you can upload for this step, as shown in the tutorial!
