Dev to cypher 25 (#1346)

Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: Jens Pryce-Åklundh <[email protected]>
Co-authored-by: NataliaIvakina <[email protected]>
Co-authored-by: Reneta Popova <[email protected]>
Co-authored-by: Neil Dewhurst <[email protected]>
Co-authored-by: Stefano Ottolenghi <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Nadja Müller <[email protected]>
Co-authored-by: Therese Magnusson <[email protected]>
Co-authored-by: Wilco <[email protected]>
Co-authored-by: JoelBergstrand <[email protected]>
Co-authored-by: Gem Lamont <[email protected]>
Co-authored-by: Arne Fischereit <[email protected]>

Author: 13 people

antora.yml

@@ -7,4 +7,4 @@ nav:
 - modules/ROOT/content-nav.adoc
 asciidoc:
   attributes:
-    neo4j-version: '2025.06'
+    neo4j-version: '2025.07'

modules/ROOT/pages/clauses/filter.adoc

@@ -93,6 +93,38 @@ RETURN p.name AS person,
 3+|Rows: 2
 |===
 
+[[filter-on-dynamic-labels-and-types]]
+== Filter on dynamic labels and types
+
+To filter on a label or relationship type using a dynamically computed value, use `$(<expr>)` where <expr> is any Cypher expression:
+
+.Parameters
+[source, parameters]
+----
+{
+  "label": "Swedish"
+}
+----
+
+.Filter on a dynamically computed node label
+// tag::clauses_where_dynamic[]
+[source, cypher]
+----
+MATCH (n)
+FILTER n:$($label)
+RETURN labels(n) AS labels
+----
+// end::clauses_where_dynamic[]
+
+.Result
+[role="queryresult",options="header,footer",cols="1*<m"]
+|===
+| labels
+| ["Person", "Swedish"]
+1+d|Rows: 1
+|===
+
+
 [[filter-on-dynamic-properties]]
 == Filter on dynamic properties
 

modules/ROOT/pages/clauses/where.adoc

@@ -103,6 +103,38 @@ RETURN f.name AS oldFriend
 |===
 
 
+[[filter-on-dynamic-labels-and-types]]
+== Filter on dynamic labels and types
+
+To filter on a label or relationship type using a dynamically computed value, use `$(<expr>)` where <expr> is any Cypher expression:
+
+.Parameters
+[source, parameters]
+----
+{
+  "label": "Swedish"
+}
+----
+
+.Filter on a dynamically computed node label
+// tag::clauses_where_dynamic[]
+[source, cypher]
+----
+MATCH (n)
+WHERE n:$($label)
+RETURN labels(n) AS labels
+----
+// end::clauses_where_dynamic[]
+
+.Result
+[role="queryresult",options="header,footer",cols="1*<m"]
+|===
+| labels
+| ["Person", "Swedish"]
+1+d|Rows: 1
+|===
+
+
 [[filter-on-dynamic-properties]]
 == Filter on dynamic properties
 

modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc

@@ -22,6 +22,31 @@ Cypher 25 was introduced in Neo4j 2025.06 and can only be used on Neo4j 2025.06+
 Features removed in Cypher 25 are still available on Neo4j 2025.06+ databases either by prepending a query with `CYPHER 5` or by having Cypher 5 as the default language for the database.
 For more information, see xref:queries/select-version.adoc[].
 
+[[cypher-deprecations-additions-removals-2025.07]]
+== Neo4j 2025.07
+
+=== Updated in Cypher 25
+
+[cols="2", options="header"]
+|===
+| Feature
+| Details
+
+a|
+label:functionality[]
+label:updated[]
+[source, cypher, role="noheader"]
+----
+MATCH (n)-[r]->()
+WHERE n:$(<expr1>)
+WITH n, r:$(<expr2>) AS hasType
+RETURN n:$(<expr3>)
+----
+
+| Added the ability to dynamically reference node labels and relationship types in places where xref:patterns/reference.adoc#label-expressions[label expressions] are allowed.
+|===
+
+
 [[cypher-deprecations-additions-removals-2025.06]]
 == Neo4j 2025.06
 

modules/ROOT/pages/patterns/reference.adoc

@@ -314,6 +314,19 @@ The following matches relationships that have a type that is neither `A` nor `B`
 -[:!A&!B]->
 ----
 
+[[dynamic-label-and-type-expressions]]
+=== Dynamic label and type expressions
+
+Node labels and relationship types can be referenced dynamically in expressions, parameters, and variables within label expressions.
+
+.Syntax for creating nodes and relationships dynamically
+[source, syntax]
+----
+dynamicLabelExpression ::= ":$(" + valueExpression ")"
+----
+
+The `valueExpression` must evaluate to a `STRING NOT NULL | LIST<STRING NOT NULL> NOT NULL` value.
+
 [[property-key-value-expressions]]
 == Property key-value expressions
 

modules/ROOT/pages/planning-and-tuning/execution-plans.adoc

@@ -141,7 +141,7 @@ The `id` column specifies a unique ID assigned to each operator.
 There are no guarantees about the order of the ids, although they will usually start with 0 at the root operator, and will increase until the leaf operator is reached at the beginning of the operator tree.
 
 The `Details` column in the middle of the execution plan describes what task is performed by each operator.
-For example, the details column of the xref::planning-and-tuning/operators/operators-detail.adoc#query-plan-repeat[Repeat(Trail)] operator in the middle of the execution plan (`id 5`), specifies that the operator traverses a quantified path pattern without an upward limit.
+For example, the details column of the xref::planning-and-tuning/operators/operators-detail.adoc#query-plan-repeat[Repeat] operator in the middle of the execution plan (`id 5`), specifies that the operator traverses a quantified path pattern without an upward limit.
 
 Finally, the `Estimated Rows` column details the number of rows that are expected to be produced by each operator.
 This estimate is an approximate number based on the available statistical information and the planner uses it to choose a suitable execution plan.footnote:[The statistical information maintained by Neo4j includes the following: the number of nodes having a certain label, the number of relationships by type, selectivity per index, and the number of relationships by type, ending with or starting from a node with a specific label.]

modules/ROOT/pages/planning-and-tuning/operators/index.adoc

@@ -423,8 +423,8 @@ Tests for the presence of a pattern predicate in queries containing multiple pat
 |
 
 | xref::planning-and-tuning/operators/operators-detail.adoc#query-plan-nullify-metadata[NullifyMetadata]
-| responsible for cleaning up the state produced by xref:planning-and-tuning/operators/operators-detail.adoc#query-plan-repeat[`Repeat(Trail)`].
-It is only planned directly after `Repeat(Trail)`.
+| responsible for cleaning up the state produced by xref:planning-and-tuning/operators/operators-detail.adoc#query-plan-repeat[`Repeat`].
+It is only planned directly after `Repeat`.
 |
 |
 | 
@@ -632,7 +632,7 @@ It also fetches the start and end nodes of those relationships.
 |
 |
 
-| xref::planning-and-tuning/operators/operators-detail.adoc#query-plan-repeat[Repeat(Trail)]
+| xref::planning-and-tuning/operators/operators-detail.adoc#query-plan-repeat[Repeat]
 | Solves quantified path patterns.
 |
 |

modules/ROOT/pages/planning-and-tuning/operators/operators-detail.adoc

@@ -4063,15 +4063,15 @@ Total database accesses: 49, total allocated memory: 1200
 
 
 [[query-plan-repeat]]
-=== Repeat (Trail)
-// Repeat(Trail)
+=== Repeat
+// Repeat
 
-Given a start node, the `Repeat(Trail)` operator will traverse xref::patterns/variable-length-patterns.adoc#quantified-path-patterns[quantified path patterns] that cannot be solved (or solved efficiently) with the xref::planning-and-tuning/operators/operators-detail.adoc#query-plan-varlength-expand-all[`VarLengthExpand(All)`] operator.
+Given a start node, the `Repeat` operator will traverse xref::patterns/variable-length-patterns.adoc#quantified-path-patterns[quantified path patterns] that cannot be solved (or solved efficiently) with the xref::planning-and-tuning/operators/operators-detail.adoc#query-plan-varlength-expand-all[`VarLengthExpand(All)`] operator.
 Similar to an xref::planning-and-tuning/operators/operators-detail.adoc#query-plan-apply[`Apply`] operator, it takes a single row from the left-hand side and applies the operators on the right-hand side.
 In contrast to `Apply`, however, it repeatedly applies these operators in accordance with the quantifiers on the quantified path pattern.
 In the following example, the operator will repeat twice and produce rows for both repetitions.
 
-.Repeat(Trail)
+.Repeat
 ======
 
 .Query
@@ -4127,8 +4127,8 @@ Total database accesses: 747, total allocated memory: 45832
 [[query-plan-nullify-metadata]]
 === Nullify Metadata
 
-`NullifyMetadata` is responsible for cleaning up the state produced by xref:planning-and-tuning/operators/operators-detail.adoc#query-plan-repeat[`Repeat(Trail)`].
-It is only planned directly after `Repeat(Trail)`.
+`NullifyMetadata` is responsible for cleaning up the state produced by xref:planning-and-tuning/operators/operators-detail.adoc#query-plan-repeat[`Repeat`].
+It is only planned directly after `Repeat`.
 
 .NullifyMetadata
 ======