Add dynamic label and type support in label expressions

Author: gem-neo4j

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 type using a dynamically computed value, use `$(<expr>)`:
+
+.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 type using a dynamically computed value, use `$(<expr>)`:
+
+.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:$(<expr>)
+WITH n, r:$(<expr>) AS hasType
+RETURN n:$(<expr>)
+----
+
+| 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