2025.03 update and procedures section

Author: JPryce-Aklundh

modules/ROOT/pages/queries/select-version.adoc

@@ -5,27 +5,33 @@
 Users can specify the version of Cypher in which they want to run their queries, choosing between Cypher 5 and Cypher 25.
 The Cypher version can be set for individual queries or as the default language for a database.
 
+[[cypher-versions-explained]]
 == Cypher 5, Cypher 25, and Neo4j explained
 
 Starting in 2025, the Neo4j server transitioned to a calendar-based versioning system.
 This means Neo4j will no longer use its previous semantic versioning and release pattern (e.g., 5.25, 5.26).
 Instead, releases from 2025 onwards will follow a *YYYY.MM* format, beginning with version 2025.01 released in January 2025, followed by 2025.02 released in February 2025, and so on.
 
-Cypher 25 is introduced alongside Neo4j 2025.02 and is the default language for databases running version 2025.02 or later.
-However, users running Neo4j version 2025.02 or later can choose to run their queries using the previous version of Cypher: Cypher 5.
+Cypher 25 is introduced alongside Neo4j 2025.03 and is the default language for newly created databases running version 2025.03 or later.
+However, users running Neo4j version 2025.03 or later can choose to run their queries using the previous version of Cypher: Cypher 5.
 If so, Neo4j will use Cypher as it existed at the time of the Neo4j 5.26 long-term support release.
 
+[NOTE]
+Databases migrating to Neo4j 2025.03+ from earlier versions will continue to use Cypher 5 as their default language.
+To change the default language on such databases, see xref:queries/select-version.adoc#alter-default-cypher-version[Alter the default Cypher version for a database] below.
+
 For information about updates to Cypher in different Neo4j versions, see xref:deprecations-additions-removals-compatibility.adoc[].
 For information about Cypher 5, see the link:https://neo4j.com/docs/cypher-manual/5/introduction/[Cypher 5 Manual].
 
+[[selection-query-cypher-version]]
 == Select the Cypher version for queries
 
 To select the Cypher version of a query, prepend it with `CYPHER <language version>`. 
 
 Selecting `CYPHER 5` ensures that the query will be executed using the language as it existed at the time of the Neo4j 5.26 long-term support release.
-Any changes introduced in Neo4j 2025.02 or later will not affect the query.
+Any changes introduced in Neo4j 2025.03 or later will not affect the query.
 
-Selecting `CYPHER 25` ensures that the query will be executed using the language as it exists in the version of Neo4j that the database is currently running, provided it is on Neo4j 2025.02 or later.
+Selecting `CYPHER 25` ensures that the query will be executed using the language as it exists in the version of Neo4j that the database is currently running, provided it is on Neo4j 2025.03 or later.
 
 Below are two examples showing the two versions of Cypher behaving differently.
 
@@ -104,6 +110,24 @@ SHOW CONSTRAINTS YIELD name, type
 If a database has specified a default Cypher version, it is possible to set a different Cypher version for individual queries.
 For example, if a database is created with Cypher 5 as its default language, prepending a query run on that database with `CYPHER 25` ensures the query uses Cypher 25.
 
+[[procedures-and-functions]]
+=== Procedures and functions
+
+link:{neo4j-docs-base-uri}/operations-manual/current/procedures[Procedures] and xref:functions/index.adoc[functions] (including built-in and link:{neo4j-docs-base-uri}/apoc/current/[APOC]) are tied to a specific Cypher language version.
+Therefore, procedures and functions in Neo4j 2025.03+ and APOC 2025.03+ (both of which have Cypher 25 as their default language), may behave differently depending on what version of Cypher is used.
+
+For example, APOC 2025.03 removed Cypher 25 support of the procedure `apoc.create.uuids()`, meaning it is not available to queries running Cypher 25.
+However, it can still be used on APOC 2025.03 if queries are prepended with `CYPHER 5`, or if the database’s default version is set to `CYPHER 5`.
+In this case, Neo4j will use APOC and Cypher as they existed at the time of the 5.26 long-term support (LTS) release.
+
+.Using a procedure removed in Cypher 25 with APOC 2025.03+
+[source, cypher]
+----
+CYPHER 5
+CALL apoc.create.uuids(10)
+----
+
+[[cypher-selection-with-other-query-options]]
 === Combine Cypher version selection with other query options
 
 It is possible to combine Cypher version selection with other xref:planning-and-tuning/query-tuning.adoc[query options].
@@ -117,9 +141,10 @@ MATCH (n:Person)
 RETURN n.name
 ----
 
+[[select-default-cypher-version]]
 == Select the default Cypher version when creating a database
 
-Databases created on Neo4j 2025.02 or later will have Cypher 25 as their default language.
+Databases created on Neo4j 2025.03 or later will have Cypher 25 as their default language.
 This is true for the link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/#manage-database-systems[system, standard, and composite] Neo4j databases.
 
 To select a different default Cypher version for a database, add `DEFAULT LANGUAGE <language version>` to the link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/standard-databases/create-databases/[`CREATE DATABASE`] statement.
@@ -129,22 +154,23 @@ This can be done on any Neo4j database.
 Selecting a default Cypher version on a database requires the `SET DEFAULT LANGUAGE` privilege.
 
 Selecting `CYPHER 5` as the default database language ensures that every query run on that database uses the language as it existed at the time of the Neo4j 5.26 long-term support release.
-Any changes introduced in Neo4j 2025.02 or later will not affect the query.
+Any changes introduced in Neo4j 2025.03 or later will not affect the semantics of the query.
 
 .Create a database with Cypher 5 as the default language
 [source, cypher]
 ----
 CREATE DATABASE my_database DEFAULT LANGUAGE CYPHER 5
 ----
 
-Selecting `CYPHER 25` ensures that the query will be executed using the language as it exists in the version of Neo4j that the database is currently running, provided it is on Neo4j 2025.02 or later.
+Selecting `CYPHER 25` ensures that the query will be executed using the language as it exists in the version of Neo4j that the database is currently running, provided it is on Neo4j 2025.03 or later.
 
 .Create a database with Cypher 25 as the default language
 [source, cypher]
 ----
 CREATE DATABASE my_new_database DEFAULT LANGUAGE CYPHER 25
 ----
 
+[[alter-default-cypher-version]]
 == Alter the default Cypher version for a database
 
 To alter the default Cypher version on a database, add `SET DEFAULT LANGUAGE <language version>` to the link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/standard-databases/alter-databases/[`ALTER DATABASE`] command.
@@ -164,6 +190,7 @@ ALTER DATABASE my_new_database SET DEFAULT LANGUAGE CYPHER 5
 ALTER DATABASE my_database SET DEFAULT LANGUAGE CYPHER 25
 ----
 
+[[show-cypher-versions]]
 == Show the Cypher version of databases
 
 The Cypher version of a database can be seen using the link:{neo4j-docs-base-uri}/operations-manual/current/database-administration/standard-databases/listing-databases/[`SHOW DATABASES`] command as follows: