neo4j · renetapopova · Jul 2, 2025 · Feb 5, 2025 · Feb 10, 2025 · Feb 10, 2025
diff --git a/antora.yml b/antora.yml
@@ -1,12 +1,12 @@
 name: status-codes
 title: Status Codes for Errors & Notifications
-version: '2025.05'
+version: '2025.06'
 start_page: ROOT:index.adoc
 nav:
 - modules/ROOT/content-nav.adoc
 asciidoc:
   attributes:
     page-origin-private: false
-    neo4j-version: '2025.05'
-    neo4j-version-exact: '2025.05.0'
-    neo4j-buildnumber: '2025.05'
+    neo4j-version: '2025.06'
+    neo4j-version-exact: '2025.06.0'
+    neo4j-buildnumber: '2025.06'
diff --git a/modules/ROOT/content-nav.adoc b/modules/ROOT/content-nav.adoc
@@ -151,6 +151,8 @@
 **** xref:errors/gql-errors/22NB7.adoc[]
 **** xref:errors/gql-errors/22NB8.adoc[]
 **** xref:errors/gql-errors/22NB9.adoc[]
+**** xref:errors/gql-errors/22NBA.adoc[]
+**** xref:errors/gql-errors/22NBC.adoc[]
 *** xref:errors/gql-errors/index.adoc#invalid-transaction-state[Invalid transaction state]
 **** xref:errors/gql-errors/25G02.adoc[]
 **** xref:errors/gql-errors/25N01.adoc[]
@@ -251,6 +253,7 @@
 **** xref:errors/gql-errors/42I59.adoc[]
 **** xref:errors/gql-errors/42I60.adoc[]
 **** xref:errors/gql-errors/42I61.adoc[]
+**** xref:errors/gql-errors/42I62.adoc[]
 **** xref:errors/gql-errors/42N00.adoc[]
 **** xref:errors/gql-errors/42N01.adoc[]
 **** xref:errors/gql-errors/42N02.adoc[]
@@ -353,6 +356,7 @@
 **** xref:errors/gql-errors/42NA7.adoc[]
 **** xref:errors/gql-errors/42NA8.adoc[]
 **** xref:errors/gql-errors/42NA9.adoc[]
+**** xref:errors/gql-errors/42NAA.adoc[]
 **** xref:errors/gql-errors/42NFC.adoc[]
 **** xref:errors/gql-errors/42NFD.adoc[]
 **** xref:errors/gql-errors/42NFE.adoc[]
@@ -451,6 +455,7 @@
 **** xref:errors/gql-errors/51N72.adoc[]
 **** xref:errors/gql-errors/51N73.adoc[]
 **** xref:errors/gql-errors/51N74.adoc[]
+**** xref:errors/gql-errors/51N76.adoc[]
 *** xref:errors/gql-errors/index.adoc#procedure-exceptions[Procedure exceptions]
 **** xref:errors/gql-errors/52N01.adoc[]
 **** xref:errors/gql-errors/52N02.adoc[]

diff --git a/modules/ROOT/pages/errors/all-errors.adoc b/modules/ROOT/pages/errors/all-errors.adoc
@@ -46,9 +46,6 @@ This is a complete list of all client errors Neo4j may return, and what they mea
 An illegal chain of aliases has been detected.
 This request cannot be executed.
 
-| Neo.ClientError.Fabric.AccessMode
-| The request could not be completed due to an access mode violation
-
 | Neo.ClientError.General.ForbiddenOnReadOnlyDatabase
 | This is a read-only database, writing or modifying the database is not allowed.
 
@@ -421,9 +418,6 @@ This is a complete list of all database errors Neo4j may return, and what they m
 | Neo.DatabaseError.Database.Unknown
 | Unknown database management error.
 
-| Neo.DatabaseError.Fabric.RemoteExecutionFailed
-| The database was unable to execute a remote part of the statement.
-
 | Neo.DatabaseError.General.IndexCorruptionDetected
 |
 The request (directly or indirectly) referred to an index that is in a failed state.

diff --git a/modules/ROOT/pages/errors/gql-errors/08N19.adoc b/modules/ROOT/pages/errors/gql-errors/08N19.adoc
@@ -1,7 +1,7 @@
 = 08N19
 
 == Status description
-error: connection exception - shard execution transient error. Communication with shard `{ <<graph>> }` failed. with message `{ <<msg>> }`.
+error: connection exception - shard execution transient error. Communication with shard `{ <<graph>> }` failed with message `{ <<msg>> }`.
 
 
 ifndef::backend-pdf[]

diff --git a/modules/ROOT/pages/errors/gql-errors/08N20.adoc b/modules/ROOT/pages/errors/gql-errors/08N20.adoc
@@ -1,7 +1,7 @@
 = 08N20
 
 == Status description
-error: connection exception - shard execution database error. Communication with shard `{ <<graph>> }` failed. with message `{ <<msg>> }`.
+error: connection exception - shard execution database error. Communication with shard `{ <<graph>> }` failed with message `{ <<msg>> }`.
 
 
 ifndef::backend-pdf[]

diff --git a/modules/ROOT/pages/errors/gql-errors/08N21.adoc b/modules/ROOT/pages/errors/gql-errors/08N21.adoc
@@ -1,7 +1,7 @@
 = 08N21
 
 == Status description
-error: connection exception - shard execution client error. Communication with shard `{ <<graph>> }` failed. with message `{ <<msg>> }`.
+error: connection exception - shard execution client error. Communication with shard `{ <<graph>> }` failed with message `{ <<msg>> }`.
 
 
 ifndef::backend-pdf[]

diff --git a/modules/ROOT/pages/errors/gql-errors/22NBA.adoc b/modules/ROOT/pages/errors/gql-errors/22NBA.adoc
@@ -0,0 +1,27 @@
+= 22NBA
+
+== Status description
+
+error: data exception - omitting mandatory field for property type constraints for vectors. Property type constraints for vectors need to define both coordinate type and dimension.
+
+== Example scenario
+
+For example, try to create a property type constraint for a vector, omitting the dimension:
+
+[source,cypher]
+----
+CREATE CONSTRAINT myConstraint
+FOR (n:Label)
+REQUIRE n.prop IS :: VECTOR<INTEGER>
+----
+
+You will receive an error with GQLSTATUS xref:errors/gql-errors/50N11.adoc[50N11].
+This error has a cause detailed in xref:errors/gql-errors/22N90.adoc[22N90], which also has a subsequent cause with GQLSTATUS 22NBA and the status description above.
+
+
+ifndef::backend-pdf[]
+[discrete.glossary]
+== Glossary
+
+include::partial$glossary.adoc[]
+endif::[]
diff --git a/modules/ROOT/pages/errors/gql-errors/22NBC.adoc b/modules/ROOT/pages/errors/gql-errors/22NBC.adoc
@@ -0,0 +1,21 @@
+= 22NBC
+
+== Status description
+
+error: data exception - index belongs to constraint. Index belongs to constraint `{ <<constrDescrOrName>> }`.
+
+== Scenario
+
+This error code is used when the user tries drop an index belonging to a constraint.
+
+== Possible solution
+
+Drop the constraint instead.
+
+
+ifndef::backend-pdf[]
+[discrete.glossary]
+== Glossary
+
+include::partial$glossary.adoc[]
+endif::[]
diff --git a/modules/ROOT/pages/errors/gql-errors/42I62.adoc b/modules/ROOT/pages/errors/gql-errors/42I62.adoc
@@ -0,0 +1,11 @@
+= 42I62
+
+== Status description
+error: syntax error or access rule violation - unsupported distance metric. Unknown distance metric:  `{ <<input>> }`.
+
+ifndef::backend-pdf[]
+[discrete.glossary]
+== Glossary
+
+include::partial$glossary.adoc[]
+endif::[]
diff --git a/modules/ROOT/pages/errors/gql-errors/42N39.adoc b/modules/ROOT/pages/errors/gql-errors/42N39.adoc
@@ -3,7 +3,7 @@
 = 42N39
 
 == Status description
-error: syntax error or access rule violation - incompatible return column names. All `{<<context>>}` must have the same return column names. Use `AS` to ensure columns have the same name.
+error: syntax error or access rule violation - incompatible return column names. All `{ <<context>> }` must have the same return column names. Use `AS` to ensure columns have the same name.
 
 ifndef::backend-pdf[]
 [discrete.glossary]

diff --git a/modules/ROOT/pages/errors/gql-errors/42NAA.adoc b/modules/ROOT/pages/errors/gql-errors/42NAA.adoc
@@ -0,0 +1,63 @@
+= 42NAA
+
+== Status description
+error: syntax error or access rule violation - incorrectly formatted graph reference. Incorrectly formatted graph reference `{ <<input>> }`. Expected a single quoted or unquoted identifier. Separate name parts should not be quoted individually.
+
+== Explanation
+As of Cypher 25, database names and aliases cannot include name parts that are quoted individually.
+Either the whole name must be quoted, or the whole name must be unquoted.
+A recommended approach, which is consistent between different commands and Cypher versions, is to send in the database name or alias as a parameter rather than a string literal.
+
+== Example scenario
+For example, try to create a database with using the following Cypher 25 command:
+
+[source,cypher]
+----
+CYPHER 25 CREATE ALIAS `foo`.`bar` FOR DATABASE baz
+----
+
+An error will be thrown with GQLSTATUS 42NAA and the following status description:
+
+[source]
+----
+error: syntax error or access rule violation - incorrectly formatted graph reference. Incorrectly formatted graph reference '`foo`.`bar`'. Expected a single quoted or unquoted identifier. Separate name parts should not be quoted individually.
+----
+
+== Possible solutions
+
+To resolve this issue, the preferred way is to replace the alias name with a parameter:
+
+.Parameters
+[source, parameters]
+----
+{
+  "aliasName": "foo.bar"
+}
+----
+
+.Query
+[source, cypher]
+----
+CREATE ALIAS $aliasName FOR DATABASE baz
+----
+
+Alternatively, if you use a string literal, the correct quoting for Cypher 25 will either be
+
+[source,cypher]
+----
+CYPHER 25 CREATE ALIAS `foo.bar` FOR DATABASE baz
+----
+
+or
+
+[source,cypher]
+----
+CYPHER 25 CREATE ALIAS foo.bar FOR DATABASE baz
+----
+
+ifndef::backend-pdf[]
+[discrete.glossary]
+== Glossary
+
+include::partial$glossary.adoc[]
+endif::[]
diff --git a/modules/ROOT/pages/errors/gql-errors/51N31.adoc b/modules/ROOT/pages/errors/gql-errors/51N31.adoc
@@ -1,8 +1,10 @@
+:page-role: changed-2025.06
+
 = 51N31
 
 == Status description
 
-error: system configuration or operation exception - not supported. `{ <<item>> }` is not supported in `{ <<context>> }`.
+error: system configuration or operation exception - not supported. `{ <<feat>> }` is not supported in `{ <<context>> }`.
 
 
 ifndef::backend-pdf[]

diff --git a/modules/ROOT/pages/errors/gql-errors/51N41.adoc b/modules/ROOT/pages/errors/gql-errors/51N41.adoc
@@ -1,7 +1,7 @@
 = 51N41
 
 == Status description
-error: system configuration or operation exception - admin operation failed. Server or database admin operation not possible.
+error: system configuration or operation exception - admin operation failed. Server or database admin operation not possible. Reason: `{ <<msg>> }`
 
 ifndef::backend-pdf[]
 [discrete.glossary]

diff --git a/modules/ROOT/pages/errors/gql-errors/51N76.adoc b/modules/ROOT/pages/errors/gql-errors/51N76.adoc
@@ -0,0 +1,16 @@
+= 51N76
+
+
+== Status description
+error: system configuration or operation exception - upgrade failed. The upgrade to a new Neo4j version failed.
+
+== Explanation
+This error code can occur during a Neo4j upgrade to a new version in the rare case when something in the user's setup or DBMS environment prevents the upgrade.
+The error will be accompanied by a cause with a more concrete GQLSTATUS, describing what the user needs to change before retrying the upgrade.
+
+ifndef::backend-pdf[]
+[discrete.glossary]
+== Glossary
+
+include::partial$glossary.adoc[]
+endif::[]
diff --git a/modules/ROOT/pages/errors/gql-errors/index.adoc b/modules/ROOT/pages/errors/gql-errors/index.adoc
@@ -106,15 +106,15 @@ Status description:: error: connection exception - general driver database error
 
 === xref:errors/gql-errors/08N19.adoc[08N19]
 
-Status description:: error: connection exception - shard execution transient error. Communication with shard `{ <<graph>> }` failed. with message `{ <<msg>> }`.
+Status description:: error: connection exception - shard execution transient error. Communication with shard `{ <<graph>> }` failed with message `{ <<msg>> }`.
 
 === xref:errors/gql-errors/08N20.adoc[08N20]
 
-Status description:: error: connection exception - shard execution database error. Communication with shard `{ <<graph>> }` failed. with message `{ <<msg>> }`.
+Status description:: error: connection exception - shard execution database error. Communication with shard `{ <<graph>> }` failed with message `{ <<msg>> }`.
 
 === xref:errors/gql-errors/08N21.adoc[08N21]
 
-Status description:: error: connection exception - shard execution client error. Communication with shard `{ <<graph>> }` failed. with message `{ <<msg>> }`.
+Status description:: error: connection exception - shard execution client error. Communication with shard `{ <<graph>> }` failed with message `{ <<msg>> }`.
 
 
 [[data-exceptions]]
@@ -611,6 +611,14 @@ Status description:: error: data exception - invalid Neo4j type. `{ <<input>> }`
 
 Status description:: error: data exception - invalid inner list type. Lists cannot have `{ <<typeDescription>> }` as an inner type in this context.
 
+=== xref:errors/gql-errors/22NBA.adoc[22NBA]
+
+Status description:: error: data exception - omitting mandatory field for property type constraints for vectors. Property type constraints for vectors need to define both coordinate type and dimension.
+
+=== xref:errors/gql-errors/22NBC.adoc[22NBC]
+
+Status description:: error: data exception - index belongs to constraint. Index belongs to constraint `{ <<constrDescrOrName>> }`.
+
 
 [[invalid-transaction-state]]
 == Invalid transaction state
@@ -1022,6 +1030,10 @@ Status description:: error: syntax error or access rule violation - invalid glob
 
 Status description:: error: syntax error or access rule violation - missing LOOKUP INDEX function name. Missing function name for the LOOKUP INDEX.
 
+=== xref:errors/gql-errors/42I62.adoc[42I62]
+
+Status description:: error: syntax error or access rule violation - unsupported distance metric. Unknown distance metric:  `{ <<input>> }`.
+
 [role=label--changed-2025.03]
 === xref:errors/gql-errors/42N00.adoc[42N00]
 
@@ -1180,7 +1192,7 @@ Status description:: error: syntax error or access rule violation - duplicate re
 [role=label--changed-2025.03]
 === xref:errors/gql-errors/42N39.adoc[42N39]
 
-Status description:: error: syntax error or access rule violation - incompatible return column names. All `{<<context>>}` must have the same return column names. Use `AS` to ensure columns have the same name.
+Status description:: error: syntax error or access rule violation - incompatible return column names. All `{ <<context>> }` must have the same return column names. Use `AS` to ensure columns have the same name.
 
 === xref:errors/gql-errors/42N3A.adoc[42N3A]
 
@@ -1434,6 +1446,10 @@ Status description:: error: syntax error or access rule violation - invalid refe
 
 Status description:: error: syntax error or access rule violation - system database procedure rules. The system database supports a restricted set of Cypher clauses. The supported clause structure for procedure calls is: `CALL`, `YIELD`, `RETURN`. `YIELD` and `RETURN` clauses are optional. The order of the clauses is fixed and each can only occur once.
 
+=== xref:errors/gql-errors/42NAA.adoc[42NAA]
+
+Status description:: error: syntax error or access rule violation - incorrectly formatted graph reference. Incorrectly formatted graph reference `{ <<input>> }`. Expected a single quoted or unquoted identifier. Separate name parts should not be quoted individually.
+
 === xref:errors/gql-errors/42NFC.adoc[42NFC]
 
 Status description:: error: syntax error or access rule violation - auth info validation error. Authentication and/or authorization could not be validated. See security logs for details.
@@ -1661,9 +1677,10 @@ Status description:: error: system configuration or operation exception - not su
 
 Status description:: error: system configuration or operation exception - not supported with this configuration. `{ <<item>> }` is not supported in `{ <<context>> }`.
 
+[role=label--changed-2025.06]
 === xref:errors/gql-errors/51N31.adoc[51N31]
 
-Status description:: error: system configuration or operation exception - not supported. `{ <<item>> }` is not supported in `{ <<context>> }`.
+Status description:: error: system configuration or operation exception - not supported. `{ <<feat>> }` is not supported in `{ <<context>> }`.
 
 === xref:errors/gql-errors/51N32.adoc[51N32]
 
@@ -1703,7 +1720,7 @@ Status description:: error: system configuration or operation exception - unable
 
 === xref:errors/gql-errors/51N41.adoc[51N41]
 
-Status description:: error: system configuration or operation exception - admin operation failed. Server or database admin operation not possible.
+Status description:: error: system configuration or operation exception - admin operation failed. Server or database admin operation not possible. Reason: `{ <<msg>> }`
 
 === xref:errors/gql-errors/51N43.adoc[51N43]
 
@@ -1833,6 +1850,10 @@ Status description:: error: system configuration or operation exception - transa
 
 Status description:: error: system configuration or operation exception - maximum number of transactions reached. Failed to start a new transaction. The limit of concurrent transactions is reached. Increase the number of concurrent transactions using `{ <<cfgSetting>> }` in the neo4j.conf file.
 
+=== xref:errors/gql-errors/51N76.adoc[51N76]
+
+Status description:: error: system configuration or operation exception - upgrade failed. The upgrade to a new Neo4j version failed.
+
 
 [[procedure-exceptions]]
 == Procedure exceptions