Current deprecations

This section lists all current deprecations in Neo4j server features, ordered alphabetically, 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.

Authentication and authorization

Neo4j 5.23

The following procedures require the SERVER MANAGEMENT privilege:

  • dbms.cluster.cordonServer()

  • dbms.cluster.setAutomaticallyEnableFreeServers()

  • dbms.cluster.uncordonServer()

Running the procedures with an admin privilege is deprecated.

CREATE DATABASE command

Neo4j 2025.06

In Cypher 25, existingData option is deprecated and has no effect, while the options seedCredentials and existingDataSeedInstance have been removed.

Neo4j 5.26

  • existingDataSeedInstance option is deprecated. It is replaced by existingDataSeedServer.

  • seedCredentials option is deprecated. It is recommended to use the CloudSeedProvider seed provider, which does not require this configuration when seeding from cloud storage. For more information see CloudSeedProvider.

Cluster

2025.05

The dbms.routing.load_balancing.plugin=server_policies configuration setting is deprecated. See Load balancing framework for more information.

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 in 5.0.0

dbms.security.oidc.<provider>.client_id

Dynamic Deprecated in 5.19

HTTP API

Neo4j 5.26

The transactional HTTP API is deprecated and replaced by the HTTP Query API, which is enabled by default in all Neo4j deployments starting with Neo4j 5.26. To enable it in earlier versions, add QUERY_API_ENDPOINTS to the configuration setting server.http_enabled_modules. For more information about the Query API, see Query API documentation.

Neo4j 5.4

raftCommandsPerSecond status endpoint field is deprecated. It is recommended to use the metric <prefix>.cluster.raft.commit_index on each server and look for divergence.

Java API

Neo4j 5.26

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

Neo4j Helm charts

Neo4j 5.26

The MinIO (an AWS S3-compatible object storage API) support for Non-TLS/SSL endpoints in the neo4j/neo4j-admin Helm charts is deprecated and replaced by s3Endpoint. See Backup and restore for more information.

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.

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.

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.

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.

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 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().

Seed providers

Neo4j 5.26

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

SSL framework

Neo4j 5.0

Versions before Neo4j 5.0 allow keys to be stored with the old PKCS #1 standard. You can identify them by the line -----BEGIN RSA PRIVATE KEY----- at the beginning of the file. While you can load and use those keys, they are considered deprecated and will be removed in a future version.

Store formats

Neo4j 5.23

standard and high_limit formats are deprecated starting from Neo4j 5.23. See Store formats → Format deprecations for more information.