Current deprecations

This section lists all deprecated Neo4j server features, including replacements where applicable. Deprecated features are only removed immediately after a long-term support (LTS) release.

For deprecations in Cypher language, see Cypher manual → Deprecations, additions, and compatibility.

Operating systems

Neo4j 2026.01

  • CentOS Stream 8.x.
    This operating system will continue to be supported along with the next LTS release in 2026, but new releases after the 2026 LTS will no longer support this platform. It is recommended to upgrade to a supported OS version before the next LTS release.

  • System V (SysV) init scripts in Neo4j Linux distributions.
    The SysV init scripts are located in /etc/rc.d/init.d/ or /etc/init.d. All currently supported Linux distributions use systemd by default, not SysV init scripts.

Neo4j 2025.10

The following Linux distributions are deprecated:

  • Red Hat Enterprise Linux 8.x

  • Debian 11.x

  • Windows Server 2022

  • MacOS 13 Ventura

  • MacOS 14 Sonoma

    These operating systems will continue to be supported along with the next LTS release in 2026, but new releases after the 2026 LTS will no longer support these platforms. It is recommended to upgrade to a supported OS version before the next LTS release.

Procedures

See all deprecated procedures
Name Community Edition Enterprise Edition Comment

dbms.cluster.recreateDatabase()

Deprecated in 2025.04
Replaced by dbms.recreateDatabase()

dbms.quarantineDatabase() Admin Only

Deprecated in 2025.01
Removed in Cypher 25
Replaced by dbms.unquarantineDatabase()

db.index.vector.createNodeIndex()

Deprecated in 5.26
Removed in Cypher 25
Replaced by the Cypher command CREATE VECTOR INDEX. For more information, see the Cypher Manual → Create a vector index.

dbms.cluster.uncordonServer()

Deprecated in 5.23.
Removed in Cypher 25
Before Neo4j 5.23, the procedure can be run only with an admin privilege.
Replaced by ENABLE SERVER.

dbms.cluster.routing.getRoutingTable()

Deprecated in 5.21.
Replaced by: dbms.routing.getRoutingTable().

cdc.current() Beta

Deprecated in 5.17
Replaced by: db.cdc.current()

cdc.earliest() Beta

Deprecated in 5.17
Replaced by: db.cdc.earliest()

cdc.query() Beta Admin Only

Deprecated in 5.17
Replaced by: db.cdc.query()

db.create.setVectorProperty() Beta

Deprecated in 5.13
Removed in Cypher 25
Replaced by: db.create.setNodeVectorProperty()

dbms.upgrade() Admin Only

Deprecated in 5.9
Removed in Cypher 25

dbms.upgradeStatus() Admin Only

Deprecated in 5.9
Removed in Cypher 25

dbms.cluster.readReplicaToggle() Admin Only

Deprecated in 5.6
Removed in Cypher 25
Replaced by: dbms.cluster.secondaryReplicationDisable().

Configuration settings

See all deprecated configuration settings
Name Community Edition Enterprise Edition Comment

dbms.routing.load_balancing.plugin

Deprecated in 2025.05

server.db.query_cache_size

Deprecated in 5.7

dbms.security.oidc.<provider>.auth_params

Dynamic Deprecated

dbms.security.oidc.<provider>.client_id

Dynamic Deprecated

Metrics

See all deprecated metrics
Name Comment

<prefix>.cluster.raft.tx_retries Deprecated in 2025.02

The metric will be removed in a future release.

Database data metrics Deprecated in 5.15

<prefix>.ids_in_use.relationship_type

<prefix>.ids_in_use.property

<prefix>.ids_in_use.relationship

If you want to have a rough metric of how big your graph is, use <prefix>.neo4j.count.relationship instead.

<prefix>.ids_in_use.node

If you want to have a rough metric of how big your graph is, use <prefix>.neo4j.count.node instead.

Logging

Neo4j 2025.05

The failureReason column of the JSON format query log is deprecated in favor of the errorInfo column. For details, refer to Logging → JSON format log entries for log type query.

Neo4j-admin tool

See all deprecated commands
Name Community Edition Enterprise Edition Comment

neo4-admin database aggregate-backup

Deprecated in 2025.01
Replaced by neo4j-admin backup aggregate
See all deprecated command options
Command Option Comment

neo4-admin database migrate

--page-cache Deprecated in 2025.04

The option is deprecated and replaced by the --max-off-heap-memory option.

Seed providers

Neo4j 5.26

S3SeedProvider is replaced by the CloudSeedProvider. For more information, see Seed from URI.

Java API

Neo4j 5.26

The server-side Notification API and the getNotifications() method of the Result Core API are deprecated.

Neo4j error codes messages

Neo4j 2025.04

Using the error messages programmatically is deprecated. Because error messages might change in a future release, please parse or use GQLSTATUS error codes in your application code. For details, see Status Codes for Errors & Notifications → List of GQLSTATUS error codes.