Cross-site scripting in Bleach
Published 2 Feb 2021 · Updated 8 Jul 2026
Is your project on an affected bleach?
Look after several Python apps? Indie watches up to 15 repos, private ones too, for $5 a month. See Indie
Affected package
- Affected
- <3.3.0
- Fixed in
- 3.3.0
pip install 'bleach>=3.3.0'Details
Impact
A mutation XSS affects users calling bleach.clean with all of:
svgormathin the allowed tagsporbrin allowed tagsstyle,title,noscript,script,textarea,noframes,iframe, orxmpin allowed tags- the keyword argument
strip_comments=False
Note: none of the above tags are in the default allowed tags and strip_comments defaults to True.
Patches
Users are encouraged to upgrade to bleach v3.3.0 or greater.
Note: bleach v3.3.0 introduces a breaking change to escape HTML comments by default.
Workarounds
- modify
bleach.cleancalls to at least one of: - not allow the
style,title,noscript,script,textarea,noframes,iframe, orxmptag - not allow
svgormathtags - not allow
porbrtags - set
strip_comments=True
- A strong Content-Security-Policy without
unsafe-inlineandunsafe-eval`script-src`s) will also help mitigate the risk.
References
- https://bugzilla.mozilla.org/show_bug.cgi?id=1689399
- https://advisory.checkmarx.net/advisory/CX-2021-4303
- https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-23980
- https://cure53.de/fp170.pdf
Credits
- Reported by Yaniv Nizry from the CxSCA AppSec group at Checkmarx
- Additional eject tags not mentioned in the original advisory and the CSP mitigation line being truncated in the revised advisory reported by Michał Bentkowski at Securitum
For more information
If you have any questions or comments about this advisory:
- Open an issue at https://github.com/mozilla/bleach/issues
- Email us at [security@mozilla.org](mailto:security@mozilla.org)
Is GHSA-vv2x-vrpj-qqpq in any of your client repos?
Checking one package by hand is fine. Checking it across forty client projects is not. NPMscan reads the lockfiles in every GitHub repo you pick, finds each project with an affected bleach, and gives you the command that fixes it.
More advisories for bleach
- MediumGHSA-gj48-438w-jh9vBleach clean() / Cleaner() fails to sanitize dangerous URI schemes in allowed formaction attributes · 16 Jun 2026
- MediumGHSA-g75f-g53v-794xBleach linkify(parse_email=True) CPU exhaustion via unbounded email regex scanning · 16 Jun 2026
- LowGHSA-8rfp-98v4-mmr6Bleach: URI sanitization allows disallowed URI schemes with Unicode > U+00A0 in output · 16 Jun 2026
- HighCVE-2020-6817regular expression denial-of-service (ReDoS) in Bleach · 30 Mar 2020
- MediumCVE-2020-6816Bleach vulnerable to mutation XSS via whitelisted math or svg and raw tag · 24 Mar 2020
- MediumCVE-2020-6802XSS in Bleach when noscript and raw tag whitelisted · 24 Feb 2020
References
- Linkgithub.com/mozilla/bleach/security/advisories/GHSA-vv2x-vrpj-qqpq
- Advisorynvd.nist.gov/vuln/detail/CVE-2021-23980
- Linkgithub.com/mozilla/bleach/commit/79b7a3c5e56a09d1d323a5006afa59b56162eb13
- Linkadvisory.checkmarx.net/advisory/CX-2021-4303
- Linkbugzilla.mozilla.org/show_bug.cgi?id=1689399
- Linkbugzilla.mozilla.org/show_bug.cgi?id=CVE-2021-23980
- Linkcure53.de/fp170.pdf
- Packagegithub.com/mozilla/bleach
- Linkgithub.com/mozilla/bleach/blob/79b7a3c5e56a09d1d323a5006afa59b56162eb13/CHANGES#L4
- Linkgithub.com/pypa/advisory-database/tree/main/vulns/bleach/PYSEC-2021-865.yaml
- Linkpypi.org/project/bleach
Advisory data from OSV.dev (opens OSV.dev in a new tab), refreshed daily.