scala / scala-xml

The standard Scala XML library


scala-xml Travis latest release for 2.11 latest release for 2.12 latest release for 2.13 Gitter

The standard Scala XML library. Please file XML issues here, not at

The decoupling of scala-xml from the Scala compiler and standard library is possible because the compiler desugars XML literals in Scala source code into a set of method calls. Alternative implementations of these calls are welcome! (The calls are unfortunately only defined by the implementation.)

API documentation is available here.

How to documentation is available in the wiki

The latest stable release of Scala XML is 1.2.0.

Milestone releases of Scala XML version 2.0 are available, starting with 2.0.0-M1. See the changes for 2.0 in

Maintenance status

This library is community-maintained. The lead maintainer is @aaron_s_hawley.

Contributors are welcome, and should read the contributor guide on the wiki.


Many old issues from the Scala JIRA issue tracker have been migrated here, but not all of them. Community assistance identifying and migrating still-relevant issues is welcome. See this page for details.

Security best practices

The XML spec has some features that are best turned off, to avoid unsavory things like file system access, DoS attacks,... Issue #17 tracks the recommended way of configuring the XML parser used by scala-xml to avoid these. This is by no means an exhaustive list. We'll be happy to incorporate your suggestions -- just comment on the ticket!

Related projects

These Projects build upon this library and increase the functionality in different ways.

  • Advxml - A lightweight, functional library combining scala-xml with cats-core
  • ezXML - This project aims to make working with scala-xml less cumbersome