.. _versioning_policy:

Versioning policy
=================

New version releases for Open Object are done every two months, at the start of the month.
Major releases occur every two years.

Each major version is supported until 24 months after the release of the next major version.
The most recent major version is supported without a fixed end date until a new major version is released
and is the only major version for which new minor versions can be released.
Within each supported major version, only the two most recent minor versions are supported
at any given time, with the oldest of these two only being supported at most 6 months after its release.

Only the latest version (the numbered version, not the technical latest-tag)
is actively maintained and under active development. Older versions only receive patches.

The table below shows each major and minor version and until what date they can receive
patches.

Open Object
-----------

+-------+---------+---------------+--------------------------+
| Major | Minor   | Release date  | Supported until          |
+=======+=========+===============+==========================+
| 4.x   |         |               |                          |
+-------+---------+---------------+--------------------------+
|       | 4.0.x   | 2026-04-13    |                          |
+-------+---------+---------------+--------------------------+

Objects API
-----------

.. note::

    Before version 4.0, the application was named Objects API and required a separate
    instance of Objecttypes API.

+-------+---------+---------------+--------------------------+
| Major | Minor   | Release date  | Supported until          |
+=======+=========+===============+==========================+
| 3.x   |         |               |                          |
+-------+---------+---------------+--------------------------+
|       | 3.6.x   | 2026-02-06    | 2028-04-13               |
+-------+---------+---------------+--------------------------+
|       | 3.5.x   | 2025-12-01    | 2026-06-01               |
+-------+---------+---------------+--------------------------+
|       | 3.4.x   | 2025-10-28    | 2026-02-06               |
+-------+---------+---------------+--------------------------+
|       | 3.3.x   | 2025-10-06    | 2025-12-01               |
+-------+---------+---------------+--------------------------+
|       | 3.2.x   | 2025-09-16    | 2025-10-28               |
+-------+---------+---------------+--------------------------+
|       | 3.1.x   | 2025-05-26    | 2025-10-06               |
+-------+---------+---------------+--------------------------+
|       | 3.0.x   | 2025-01-22    | 2025-09-16               |
+-------+---------+---------------+--------------------------+
| 2.x   |         |               |                          |
+-------+---------+---------------+--------------------------+
|       | 2.5.x   | 2025-01-09    | 2027-01-22               |
+-------+---------+---------------+--------------------------+
|       | 2.4.x   | 2024-07-05    | 2025-01-05               |
+-------+---------+---------------+--------------------------+
|       | 2.3.x   | 2024-03-15    | 2025-01-09               |
+-------+---------+---------------+--------------------------+
|       | 2.2.x   | 2024-01-30    | 2024-07-05               |
+-------+---------+---------------+--------------------------+
|       | 2.1.x   | 2022-05-17    | 2024-03-15               |
+-------+---------+---------------+--------------------------+
|       | 2.0.x   | 2021-09-22    | 2024-01-30               |
+-------+---------+---------------+--------------------------+
| 1.x   |         |               |                          |
+-------+---------+---------------+--------------------------+
|       | 1.1.x   | 2021-04-21    | 2023-09-22               |
+-------+---------+---------------+--------------------------+
|       | 1.0.x   | 2021-01-13    | 2021-07-13               |
+-------+---------+---------------+--------------------------+

Objecttypes API
---------------

.. note:: Objects API was changed to Open Object in 4.0.0 which includes the Objecttypes API.
    Active development for the standalone Objecttypes API application has stopped since version 3.4.
    Patches can still be applied if needed.

+-------+---------+---------------+--------------------------+
| Major | Minor   | Release date  | Supported until          |
+=======+=========+===============+==========================+
| 3.x   |         |               |                          |
+-------+---------+---------------+--------------------------+
|       | 3.4.x   | 2025-12-01    | 2028-04-09               |
+-------+---------+---------------+--------------------------+
|       | 3.3.x   | 2025-10-06    | 2026-04-06               |
+-------+---------+---------------+--------------------------+
|       | 3.2.x   | 2025-08-07    | 2025-12-01               |
+-------+---------+---------------+--------------------------+
|       | 3.1.x   | 2025-07-10    | 2025-10-06               |
+-------+---------+---------------+--------------------------+
|       | 3.0.x   | 2025-01-22    | 2025-08-07               |
+-------+---------+---------------+--------------------------+
| 2.x   |         |               |                          |
+-------+---------+---------------+--------------------------+
|       | 2.3.x   | 2025-01-10    | 2027-01-22               |
+-------+---------+---------------+--------------------------+
|       | 2.2.x   | 2024-06-27    | 2024-12-27               |
+-------+---------+---------------+--------------------------+
|       | 2.1.x   | 2022-06-24    | 2025-01-10               |
+-------+---------+---------------+--------------------------+
|       | 2.0.x   | 2021-10-04    | 2024-06-27               |
+-------+---------+---------------+--------------------------+
| 1.x   |         |               |                          |
+-------+---------+---------------+--------------------------+
|       | 1.1.x   | 2021-04-21    | 2023-10-04               |
+-------+---------+---------------+--------------------------+
|       | 1.0.x   | 2021-01-13    | 2021-07-13               |
+-------+---------+---------------+--------------------------+