UPSTREAM FIX

magento2-39867: Comments below system.xml field items fail XSD validation

Community fix magento2-39867 merged into magento/magento2 on 2025-08-07, released in 2.4.9; applies cleanly to 33 releases from 2.4.6 to 2.4.8-p5.

Comments below system.xml field items fail XSD validation edited

Pull request title
xsd validation fails on etc/adminhtml/system.xml files that contain comments below field items.
Pull request
magento/magento2#39867
Issues
#39148 human
Author
@jakwinkler
Merged
2025-08-07
Fixed in
2.4.9
Reported on
—
Categories
—
Components
magento/module-config

Labels

Area
Framework
Component
Xml
Priority
P2
Severity
—
Reported on (labels)
2.4.x

Issue

Title and steps come from the upstream issue and pull request.

The upstream issue and pull request have no structured description.

Code match per tag

Each tag was checked with git apply --check against that tag's files. A clean match means the change applies; it is not a test result. Tags that already contain the fix are marked.

LineCode match per tagTests
2.4.6
2.4.6 clean 2.4.6-p1 clean 2.4.6-p2 clean 2.4.6-p3 clean 2.4.6-p4 clean 2.4.6-p5 clean 2.4.6-p6 clean 2.4.6-p7 clean 2.4.6-p8 clean 2.4.6-p9 clean 2.4.6-p10 clean 2.4.6-p11 clean 2.4.6-p12 clean 2.4.6-p13 clean 2.4.6-p14 clean 2.4.6-p15 clean
2.4.6: no test data 2.4.6-p1: no test data 2.4.6-p2: no test data 2.4.6-p3: no test data 2.4.6-p4: no test data 2.4.6-p5: no test data 2.4.6-p6: no test data 2.4.6-p7: no test data 2.4.6-p8: no test data 2.4.6-p9: no test data 2.4.6-p10: no test data 2.4.6-p11: no test data 2.4.6-p12: no test data 2.4.6-p13: no test data 2.4.6-p14: no test data 2.4.6-p15: no test data
2.4.7
2.4.7 clean 2.4.7-p1 clean 2.4.7-p2 clean 2.4.7-p3 clean 2.4.7-p4 clean 2.4.7-p5 clean 2.4.7-p6 clean 2.4.7-p7 clean 2.4.7-p8 clean 2.4.7-p9 clean 2.4.7-p10 clean
2.4.7: no test data 2.4.7-p1: no test data 2.4.7-p2: no test data 2.4.7-p3: no test data 2.4.7-p4: no test data 2.4.7-p5: no test data 2.4.7-p6: no test data 2.4.7-p7: no test data 2.4.7-p8: no test data 2.4.7-p9: no test data 2.4.7-p10: no test data
2.4.8
2.4.8 clean 2.4.8-p1 clean 2.4.8-p2 clean 2.4.8-p3 clean 2.4.8-p4 clean 2.4.8-p5 clean
2.4.8: no test data 2.4.8-p1: no test data 2.4.8-p2: no test data 2.4.8-p3: no test data 2.4.8-p4: no test data 2.4.8-p5: no test data
2.4.9
2.4.9 conflictcontains the fix
2.4.9: no test data

Triage

Model @cf/cloudflare/clef. Probability this is a bug fix: 78.4%. Probability it is security relevant: 0.5%.

Show the model's answers and probabilities
QuestionAnswerProbabilitiesConfidence
Change kindbugfixbugfix 88.7%, refactor 5.3%, docs_only 2.1%, feature 1.6%, dependency 1.4%, tests_only 0.9%74.9%
Areaframeworkframework 71.6%, admin 19.6%, other 4.4%48.9%
Reported versionunspecifiedunspecified 28.5%, 2.4.6 2.9%, 2.4.8 2.7%7.9%
Scope1.05 of 21 48.3%, 2 28.4%, 0 23.3%5.3%
Risk0.21 of 20 83.5%, 1 12.3%, 2 4.2%57.0%
Worth backporting0.54 of 20 61.2%, 1 23.8%, 2 15.0%18.1%

Download

For cweagans/composer-patches, choose a version below and download the bundle. Copy its magento2-39867/ folder into patches/composer/, merge composer.patches.json into composer.json, then run composer install. Test files are always removed; paths are relative to each package root, using the default -p1 level.

Packages (1): magento/module-config
Bundle README (what the ZIP ships)
# magento2-39867

Community fix merged upstream into magento/magento2, adapted by magento.watch.
This is not a patch published by Adobe.

Pull request: https://github.com/magento/magento2/pull/39867
Issue: https://github.com/magento/magento2/issues/39148
Author: @jakwinkler
Source commit: a8058d6a21d62d1982ef6bc26a748ac1422bf060
Modifications: test files and documentation removed, paths rewritten relative to each Composer package.
Licence: OSL-3.0 / AFL-3.0, as the original Magento Open Source code.
Maintainer: Łukasz Bajsarowicz (@lbajsarowicz)

Licence: Magento Open Source code under OSL-3.0 and AFL-3.0. The bundle carries the original author, source commit and the list of modifications.

Sources

Łukasz Bajsarowicz
Built by

Łukasz Bajsarowicz, e-commerce architect

Magento and Adobe Commerce architecture, upgrades, performance and audits for merchants and agencies since 2015; magento.watch is the tooling I use on those projects.

Open source, maintained on weekends.