GITBOOK-2191: DOCS-6071: Document OLD_VALUE() function.

mariadb-stefan-hinz · gitbook-bot · commit 4d4fbacf8762 · 2026-03-31T11:39:54.000Z
diff --git a/server/SUMMARY.md b/server/SUMMARY.md
@@ -1992,6 +1992,7 @@
         * [MASTER\_GTID\_WAIT](reference/sql-functions/secondary-functions/miscellaneous-functions/master_gtid_wait.md)
         * [MASTER\_POS\_WAIT](reference/sql-functions/secondary-functions/miscellaneous-functions/master_pos_wait.md)
         * [NAME\_CONST](reference/sql-functions/secondary-functions/miscellaneous-functions/name_const.md)
+        * [OLD\_VALUE](reference/sql-functions/secondary-functions/miscellaneous-functions/values-value.md)
         * [RELEASE\_ALL\_LOCKS](reference/sql-functions/secondary-functions/miscellaneous-functions/release_all_locks.md)
         * [RELEASE\_LOCK](reference/sql-functions/secondary-functions/miscellaneous-functions/release_lock.md)
         * [SLEEP](reference/sql-functions/secondary-functions/miscellaneous-functions/sleep.md)
@@ -2000,7 +2001,7 @@
         * [UUID\_SHORT](reference/sql-functions/secondary-functions/miscellaneous-functions/uuid_short.md)
         * [UUID\_v4](reference/sql-functions/secondary-functions/miscellaneous-functions/uuid_v4.md)
         * [UUID\_v7](reference/sql-functions/secondary-functions/miscellaneous-functions/uuid_v7.md)
-        * [VALUES / VALUE](reference/sql-functions/secondary-functions/miscellaneous-functions/values-value.md)
+        * [VALUES / VALUE](reference/sql-functions/secondary-functions/miscellaneous-functions/values-value-1.md)
     * [Special Functions](reference/sql-functions/special-functions/README.md)
       * [Dynamic Columns Functions](reference/sql-functions/special-functions/dynamic-columns-functions/README.md)
         * [COLUMN\_ADD](reference/sql-functions/special-functions/dynamic-columns-functions/column_add.md)
diff --git a/server/reference/sql-functions/function-and-operator-reference.md b/server/reference/sql-functions/function-and-operator-reference.md
@@ -531,7 +531,7 @@ description: >-
 | [UUIDv4](secondary-functions/miscellaneous-functions/uuid_v4.md)                                                                        | Returns a Universal Unique Identifier v4                                                                                  | [MariaDB 11.7](https://app.gitbook.com/s/aEnK0ZXmUbJzqQrTjFyb/community-server/old-releases/11.7/what-is-mariadb-117)                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | [UUIDv7](secondary-functions/miscellaneous-functions/uuid_v7.md)                                                                        | Returns a Universal Unique Identifier v7                                                                                  | [MariaDB 11.7](https://app.gitbook.com/s/aEnK0ZXmUbJzqQrTjFyb/community-server/old-releases/11.7/what-is-mariadb-117)                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | [UUID\_SHORT](secondary-functions/miscellaneous-functions/uuid_short.md)                                                                | Return short universal identifier                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
-| [VALUES or VALUE](secondary-functions/miscellaneous-functions/values-value.md)                                                          | Refer to columns in INSERT ... ON DUPLICATE KEY UPDATE                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| [VALUES or VALUE](secondary-functions/miscellaneous-functions/values-value-1.md)                                                        | Refer to columns in INSERT ... ON DUPLICATE KEY UPDATE                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
 | [VAR\_POP](aggregate-functions/var_pop.md)                                                                                              | Population standard variance                                                                                              |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
 | [VAR\_SAMP](aggregate-functions/var_samp.md)                                                                                            | Returns the sample variance                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
 | [VARIANCE](aggregate-functions/variance.md)                                                                                             | Population standard variance                                                                                              |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
diff --git a/server/reference/sql-functions/secondary-functions/miscellaneous-functions/values-value-1.md b/server/reference/sql-functions/secondary-functions/miscellaneous-functions/values-value-1.md
@@ -0,0 +1,34 @@
+---
+description: >-
+  Access values in ON DUPLICATE KEY UPDATE. This function retrieves the value
+  that would have been inserted into a column if no key conflict occurred.
+---
+
+# VALUES / VALUE
+
+## Syntax
+
+```sql
+VALUE(col_name)
+```
+
+## Description
+
+In an [INSERT ... ON DUPLICATE KEY UPDATE](../../../sql-statements/data-manipulation/inserting-loading-data/insert-on-duplicate-key-update.md) statement, you can use the `VALUES(col_name)` function in the [UPDATE](../../../sql-statements/data-manipulation/changing-deleting-data/update.md) clause to refer to column values from the [INSERT](../../../sql-statements/data-manipulation/inserting-loading-data/insert.md) portion of the statement. In other words, `VALUES(col_name)` in the `UPDATE` clause refers to the value of col\_name that would be inserted, had no duplicate-key conflict occurred. This function is especially useful in multiple-row inserts.
+
+The `VALUES()` function is meaningful only in `INSERT ... ON DUPLICATE KEY UPDATE` statements and returns `NULL` otherwise.
+
+This function was renamed to `VALUE()`, because it's incompatible with the standard Table Value Constructors syntax.
+
+The `VALUES()` function can still be used but only in `INSERT ... ON DUPLICATE KEY UPDATE` statements; it's a syntax error otherwise.
+
+## Examples
+
+```sql
+INSERT INTO t (a,b,c) VALUES (1,2,3),(4,5,6)
+    ON DUPLICATE KEY UPDATE c=VALUE(a)+VALUE(b);
+```
+
+<sub>_This page is licensed: GPLv2, originally from_</sub> [<sub>_fill\_help\_tables.sql_</sub>](https://github.com/MariaDB/server/blob/main/scripts/fill_help_tables.sql)
+
+{% @marketo/form formId="4316" %}
diff --git a/server/reference/sql-functions/secondary-functions/miscellaneous-functions/values-value.md b/server/reference/sql-functions/secondary-functions/miscellaneous-functions/values-value.md
@@ -4,29 +4,31 @@ description: >-
   that would have been inserted into a column if no key conflict occurred.
 ---
 
-# VALUES / VALUE
+# OLD\_VALUE
+
+{% hint style="info" %}
+This function is available from MariaDB 13.0.
+{% endhint %}
 
 ## Syntax
 
 ```sql
-VALUE(col_name)
+OLD_VALUE(val)
 ```
 
 ## Description
 
-In an [INSERT ... ON DUPLICATE KEY UPDATE](../../../sql-statements/data-manipulation/inserting-loading-data/insert-on-duplicate-key-update.md) statement, you can use the `VALUES(col_name)` function in the [UPDATE](../../../sql-statements/data-manipulation/changing-deleting-data/update.md) clause to refer to column values from the [INSERT](../../../sql-statements/data-manipulation/inserting-loading-data/insert.md) portion of the statement. In other words, `VALUES(col_name)` in the `UPDATE` clause refers to the value of col\_name that would be inserted, had no duplicate-key conflict occurred. This function is especially useful in multiple-row inserts.
-
-The `VALUES()` function is meaningful only in `INSERT ... ON DUPLICATE KEY UPDATE` statements and returns `NULL` otherwise.
-
-This function was renamed to `VALUE()`, because it's incompatible with the standard Table Value Constructors syntax.
-
-The `VALUES()` function can still be used but only in `INSERT ... ON DUPLICATE KEY UPDATE` statements; it's a syntax error otherwise.
+In the `RETURNING` clause of an [`UPDATE`](../../../sql-statements/data-manipulation/changing-deleting-data/update.md) statement, `OLD_VALUE()` returns the value before the update. The function is meaningful only in this context.
 
 ## Examples
 
 ```sql
-INSERT INTO t (a,b,c) VALUES (1,2,3),(4,5,6)
-    ON DUPLICATE KEY UPDATE c=VALUE(a)+VALUE(b);
+UPDATE t SET a=a+1 RETURNING OLD_VALUE(a) AS old, a as new;
++------+------+
+| old  | new  |
++------+------+
+|    1 |    2 |
++------+------+
 ```
 
 <sub>_This page is licensed: GPLv2, originally from_</sub> [<sub>_fill\_help\_tables.sql_</sub>](https://github.com/MariaDB/server/blob/main/scripts/fill_help_tables.sql)
diff --git a/server/reference/sql-statements/data-manipulation/inserting-loading-data/insert-on-duplicate-key-update.md b/server/reference/sql-statements/data-manipulation/inserting-loading-data/insert-on-duplicate-key-update.md
@@ -49,7 +49,7 @@ If more than one unique index is matched, only the first is updated. It is not r
 
 If the table has an [AUTO\_INCREMENT](../../../data-types/auto_increment.md) [primary key](../../../../mariadb-quickstart-guides/mariadb-indexes-guide.md#primary-key) and the statement inserts or updates a row, the [LAST\_INSERT\_ID()](../../../sql-functions/secondary-functions/information-functions/last_insert_id.md) function returns its AUTO\_INCREMENT value.
 
-The [VALUES()](../../../sql-functions/secondary-functions/miscellaneous-functions/values-value.md) function can only be used in a `ON DUPLICATE KEY UPDATE` clause and has no meaning in any other context. It returns the column values from the `INSERT` portion of the statement. This function is particularly useful for multi-rows inserts.
+The [VALUES()](../../../sql-functions/secondary-functions/miscellaneous-functions/values-value-1.md) function can only be used in a `ON DUPLICATE KEY UPDATE` clause and has no meaning in any other context. It returns the column values from the `INSERT` portion of the statement. This function is particularly useful for multi-rows inserts.
 
 The [IGNORE](ignore.md) and [DELAYED](insert-delayed.md) options are ignored when you use `ON DUPLICATE KEY UPDATE`.
 
@@ -199,7 +199,7 @@ INSERT INTO table (a,b,c) VALUES (1,2,3),(4,5,6)
     ON DUPLICATE KEY UPDATE c=VALUES(a)+VALUES(b);
 ```
 
-See the [VALUES()](../../../sql-functions/secondary-functions/miscellaneous-functions/values-value.md) function for more.
+See the [VALUES()](../../../sql-functions/secondary-functions/miscellaneous-functions/values-value-1.md) function for more.
 
 ## See Also
 
@@ -210,7 +210,7 @@ See the [VALUES()](../../../sql-functions/secondary-functions/miscellaneous-func
 * [Concurrent Inserts](concurrent-inserts.md)
 * [INSERT - Default & Duplicate Values](insert-default-duplicate-values.md)
 * [INSERT IGNORE](insert-ignore.md)
-* [VALUES()](../../../sql-functions/secondary-functions/miscellaneous-functions/values-value.md)
+* [VALUES()](../../../sql-functions/secondary-functions/miscellaneous-functions/values-value-1.md)
 
 <sub>_This page is licensed: CC BY-SA / Gnu FDL_</sub>
 
diff --git a/server/reference/sql-statements/geometry-constructors/miscellaneous-gis-functions/st_geohash.md b/server/reference/sql-statements/geometry-constructors/miscellaneous-gis-functions/st_geohash.md
@@ -8,7 +8,7 @@ description: >-
 # ST\_GeoHash
 
 {% hint style="info" %}
-ST\_GeoHash is available from [MariaDB 12.0](https://app.gitbook.com/s/aEnK0ZXmUbJzqQrTjFyb/community-server/release-notes-mariadb-12.0-rolling-releases/what-is-mariadb-120).
+ST\_GeoHash is available from [MariaDB 12.0](https://app.gitbook.com/s/aEnK0ZXmUbJzqQrTjFyb/community-server/old-releases/12.0/what-is-mariadb-120).
 {% endhint %}
 
 ## Syntax
diff --git a/server/server-management/install-and-upgrade-mariadb/upgrading/upgrading-to-unmaintained-mariadb-releases/upgrading-from-mariadb-102-to-mariadb-103.md b/server/server-management/install-and-upgrade-mariadb/upgrading/upgrading-to-unmaintained-mariadb-releases/upgrading-from-mariadb-102-to-mariadb-103.md
@@ -99,7 +99,7 @@ The following options should be removed or renamed if you use them in your [opti
 
 #### Functions
 
-* As a result of implementing Table Value Constructors, the [VALUES function](../../../../reference/sql-functions/secondary-functions/miscellaneous-functions/values-value.md) has been renamed to VALUE().
+* As a result of implementing Table Value Constructors, the [VALUES function](../../../../reference/sql-functions/secondary-functions/miscellaneous-functions/values-value-1.md) has been renamed to VALUE().
 * Functions that used to only return 64-bit now can return 32-bit results ([MDEV-12619](https://jira.mariadb.org/browse/MDEV-12619)). This could cause incompatibilities with strongly-typed clients.
 
 #### mysqldump
