You can browse existing issues and feature requests, or report a new bug, via the issue list.

If you are not sure whether something is a bug, or just want a hand, please join the discussion.

If your question is about how to use jsoup, please use the discussion forum rather than opening a GitHub issue.

What constitutes a bug?

jsoup covers HTML parsing, selector-based extraction, DOM traversal and manipulation, cleaning HTML, and HTTP fetching. In general, a bug is when one of those features behaves incorrectly, inconsistently, or differently from the documented API contract.

For HTML parsing in particular, jsoup aims to follow the HTML Living Standard and to produce effectively the same parse tree that a modern browser would for real-world HTML.

If jsoup parses a document incorrectly, if cleaning or request handling behaves unexpectedly, or if any part of the library differs from the documentation, that is a bug.

For the fastest fix, please include a small reproducing example: your code, the input HTML or URL, the output you expected, and the output you actually saw.