Skip to content

Automated Dependency Updates for Maven

Categories: java

Renovate supports updating Maven dependencies.

File Matching

By default, Renovate will check any files matching any of the following regular expressions:

/(^|/|\.)pom\.xml$/
/^(((\.mvn)|(\.m2))/)?settings\.xml$/
/(^|/)\.mvn/extensions\.xml$/

For details on how to extend a manager's managerFilePatterns value, please follow this link.

Supported datasources

This manager supports extracting the following datasources: maven, docker.

Dependency types

This manager extracts the following depType values:

depType Description
compile Dependency with compile scope (default); available on all classpaths
provided Dependency with provided scope; expected to be supplied by the JDK or container at runtime
runtime Dependency with runtime scope; required at runtime but not for compilation
test Dependency with test scope; only used for test compilation and execution
system Dependency with system scope; similar to provided but the JAR is specified explicitly
import Dependency with import scope; used to import dependency management from another POM (BOM)
optional Optional dependency (declared with <optional>true</optional>)
build A build plugin or extension (<plugin> or <extension> element)
parent The parent POM (<parent> element)
parent-root A parent POM that is itself a root POM or has an external parent; promoted from parent during multi-module resolution

Default config

{
  "managerFilePatterns": [
    "/(^|/|\\.)pom\\.xml$/",
    "/^(((\\.mvn)|(\\.m2))/)?settings\\.xml$/",
    "/(^|/)\\.mvn/extensions\\.xml$/"
  ]
}

Additional Information

The maven manager focuses on extracting dependencies from pom.xml. It uses the official Maven versioning scheme. XML files must declare official namespaces to be parsed correctly (see Maven documentation on pom.xml, extensions.xml).

It also supports Image Customizations of spring-boot's OCI packaging. Usage of registryAliases is possible only for container image references.

Limitations

Currently maven properties are not supported for buildpack related dependencies.

Open items

The below list of features and bugs were current when this page was generated on April 08, 2026.

Feature requests

  • Support maven variables for package replacements #34088
  • Support constraintsFiltering=strict for maven #25961
  • Support detectGlobalManagerConfig for Maven settings.xml #23009
  • Detect dependencies defined with properties in maven profiles #18229
  • Maven: bumpVersion update child pom.xml versions in multi module projects #14703

Bug reports

  • Maven extract fails to resolve placeholders from parent module #31004
  • Maven: ensure correct ordering of registryUrls #22811