New versions are released for a variety of reasons, for example, to improve accuracy, increase availability, and support new document elements, such as selection marks.
Given that Document AI is powered by generative AI, future versions are using new foundation models so you can benefit from generative AI enhancements.
As we improve foundation models, earlier foundation models are deprecated. Similarly, processor versions are deprecated six months after new versions are released.
A processor can have one of the following versions:
- Stable version
- Release candidate (RC)
- Customized version and its associated base version
This page describes how processors are versioned, and how to view and select a particular version.
Processor versions overview
There are two categories of processor versions:
- Google versions are either stable (for production use cases) or release candidates (experimental with latest functionality).
- User versions are created by you to customize predictions for your documents and have alphanumeric version IDs.
Google versions
Each Google version is identified by a Version ID, for example pretrained-TYPE-vX.X-YYYY-MM-DD.
Each processor version Google offers is named either Google Stable or Google Release Candidate (RC).
Google stable versions
Stable versions are production-quality and ready for use.
- Google prioritizes stability of the processor behaviour, but still includes critical fixes.
- Earlier Google stable versions are deprecated six months after the newest stable version is released as depicted in the following figure.
Google release candidates (RC)
Release candidates are experimental and are upgraded regularly with the latest features. These are not production-quality versions, and their stability may vary.
Customized versions
Customized versions are the processor versions that you can create based on your
documents to customize predictions.
Customized versions have a Type, which shows the kind of model used for predictions.
If you create a version using a foundation model (either by creating a version or
fine tuning), then the type is Generative AI. If you create a processor version
by training a smaller, custom model (either model or template based), then the
type is Custom. If you create processor versions, you decide the name and ID.
Base versions
If you create a processor version, the "base version" shows which Google version powers your customized user version. The base version dictates the lifecycle of your user version. You need to make decisions about how to manage the lifecycle of your customized user version.
Available stable processor versions
You can review the available stable processor versions for the different processor types in the following tables.
| Custom Extractor | Release date | Deprecation date |
|---|---|---|
pretrained-foundation-model-v1.5-2025-05-05 |
May 5, 2025 | Not applicable |
pretrained-foundation-model-v1.5-pro-2025-06-20 |
June 20, 2025 | Not applicable |
| Form Parser | Release date | Deprecation date |
|---|---|---|
pretrained-form-parser-v1.0-2020-09-23 |
September 23, 2020 | Not applicable |
pretrained-form-parser-v2.0-2022-11-10 |
November 10, 2022 | Not applicable |
| Layout Parser | Release date | Deprecation date |
|---|---|---|
pretrained-layout-parser-v1.0-2024-06-03 |
June 3, 2024 | Not applicable |
| Bank Statement Parser | Release date | Deprecation date |
|---|---|---|
pretrained-bankstatement-v1.0-2021-08-08 |
August 8, 2021 | Not applicable |
pretrained-bankstatement-v1.1-2021-08-13 |
August 13, 2021 | Not applicable |
pretrained-bankstatement-v2.0-2021-12-10 |
December 10, 2021 | Not applicable |
pretrained-bankstatement-v3.0-2022-05-16 |
May 16, 2022 | Not applicable |
pretrained-bankstatement-v5.0-2023-12-06 |
December 6, 2023 | Not applicable |
| W2 Parser | Release date | Deprecation date |
|---|---|---|
pretrained-w2-v1.0-2020-10-01 |
October 1, 2020 | March 31, 2024 |
pretrained-w2-v1.1-2022-01-27 |
January 27, 2022 | March 31, 2024 |
pretrained-w2-v1.2-2022-01-28 |
January 28, 2022 | Not applicable |
pretrained-w2-v2.1-2022-06-08 |
June 8, 2022 | Not applicable |
| Identity Document Proofing Parser | Release date | Deprecation date |
|---|---|---|
pretrained-id-proofing-v1.0-2022-10-03 |
October 3, 2022 | Not applicable |
| Pay Slip Parser | Release date | Deprecation date |
|---|---|---|
pretrained-paystub-v1.0-2021-03-19 |
March 19, 2021 | Not applicable |
pretrained-paystub-v1.1-2021-08-13 |
August 13, 2021 | Not applicable |
pretrained-paystub-v1.2-2021-12-10 |
December 10, 2021 | Not applicable |
pretrained-paystub-v2.0-2022-07-22 |
July 22, 2022 | Not applicable |
pretrained-paystub-v3.0-2023-12-06 |
December 6, 2023 | Not applicable |
| US Driver License Parser | Release date | Deprecation date |
|---|---|---|
pretrained-us-driver-license-v1.0-2021-06-14 |
June 14, 2021 | Not applicable |
| Expense Parser | Release date | Deprecation date |
|---|---|---|
pretrained-expense-v1.1-2021-04-09 |
April 9, 2024 | Not applicable |
pretrained-expense-v1.4-2022-11-18 |
November 18, 2022 | Not applicable |
pretrained-expense-v1.4.2-2024-09-12 |
September 12, 2024 | Not applicable |
| Invoice Parser |
|---|