# MetaPhlAn 4 + HUMAnN 4 compatibility

**URL:** <https://forum.biobakery.org/t/metaphlan-4-humann-4-compatibility/8523>\
**Category:** HUMAnN\
**Created:** [September 25, 2025, 5:54pm UTC](https://forum.biobakery.org/t/metaphlan-4-humann-4-compatibility/8523 "2025-09-25T17:54:58Z")\
**Posts on this page:** 1\
**Showing post:** 17

<div class="post-metadata">

**Author:** ![fmerinocasallo](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/fmerinocasallo/32/3368_2.png) [@fmerinocasallo](https://forum.biobakery.org/u/fmerinocasallo)\
**Post date:** [January 28, 2026, 7:35am UTC](https://forum.biobakery.org/t/metaphlan-4-humann-4-compatibility/8523/17 "2026-01-28T07:35:41Z")

</div>

This is how the file structure looks on my system:

```auto
$ tree --filelimit=10 data/databases/humann/
data/databases/humann/
├── chocophlan [30094 entries exceeds filelimit, not opening dir]
├── uniref
│ └── humann4_protein_database_filtered_v2019_06.dmnd
└── utility_mapping [21 entries exceeds filelimit, not opening dir]

$ ls data/databases/humann/chocophlan/ | head
SGB10000_pangenome90.fna.gz
SGB100018_pangenome90.fna.gz
SGB10001_pangenome90.fna.gz
SGB10002_pangenome90.fna.gz
SGB10003_pangenome90.fna.gz
SGB10004_pangenome90.fna.gz
SGB10005_pangenome90.fna.gz
SGB10006_pangenome90.fna.gz
SGB100078_pangenome90.fna.gz
SGB100087_pangenome90.fna.gz

$ ls data/databases/humann/utility_mapping/
map_eggnog_name.txt.gz map_ko_uniref90.txt.gz map_pfam_name.txt.gz metacyc_reactions_level4ec_only.uniref.bz2 vOct22_SGB_mapping.tsv
map_eggnog_uniref90.txt.gz map_level4ec_name.txt.gz map_pfam_uniref90.txt.gz mpa_vJan21_CHOCOPhlAnSGB_202103.tsv
map_go_name.txt.gz map_level4ec_uniclust90.txt.gz map_uniclust50_uniclust90.txt.gz mpa_vOct22_CHOCOPhlAnSGB_202403_species.txt
map_go_uniref90.txt.gz map_metacyc-pwy_name.txt.gz map_uniref90_name.txt.bz2 unipathway_pathways
map_ko_name.txt.gz map_metacyc-rxn_name.txt.gz metacyc_pathways_structured_filtered_v24_subreactions unipathway_uniprots.uniref.bz2

```

In my `utility_mapping` subdirectory, I see the `mpa_vJan21_CHOCOPhlAnSGB_202103.tsv` file instead of `mpa_vOct22_CHOCOPhlAnSGB_202403.tsv`, which I’d expected from the `vOct22` CHOCOPhlAn SGB database. I’ve raised that potential issue in [a separate thread](https://forum.biobakery.org/t/missing-mpa-voct22-chocophlansgb-202403-tsv-in-humann-4-utility-mapping-database/8643) with the maintainers, but there’s been no confirmation or fix so far.

Do you also have this `mpa_vJan21_CHOCOPhlAnSGB_202103.tsv` file in your `utility_mapping` subdirectory, or does your setup match the `vOct22` naming instead?

---

_[View the full topic](https://forum.biobakery.org/t/metaphlan-4-humann-4-compatibility/8523)._