Are Custom models are supported by Document Intelligence v3.1 containers?

Question

Are Custom models are supported by Document Intelligence v3.1 containers?

etan 0

Hi Microsoft Support,

Can you please advise the status of Azure Document Intelligence v3.1 Container support for Custom Models?

According to this page https://free.blessedness.top/en-us/azure/ai-services/document-intelligence/containers/install-run?view=doc-intel-4.0.0&tabs=layout, it says "Custom models are supported by Document Intelligence v3.0 containers.". So it seems there is no v3.1 Container support for Custom Models.

However I can see on this page that "Custom Template 3.1" container image is available: https://free.blessedness.top/en-us/azure/ai-services/document-intelligence/containers/image-tags?view=doc-intel-3.1.0

Please let us know if Custom Models are indeed supported by Azure Document Intelligence v3.1 Container.

Regards,

Eng

Anshika Varshney 1,910 Reputation points Microsoft External Staff Moderator

2025-10-13T23:52:41.98+00:00

Hello E T,

Thank you for reaching out on the Microsoft Q&A.

Could you please check and provide us the requested details in the private message?
etan 0 Reputation points

2025-10-13T23:59:19.01+00:00

Hi Anshika Varshney,

Thanks for your response.

I prefer to discuss on this Q&A ticket if that's ok with you.

What is Microsoft official status for Document Intelligence v3.1 container support for Custom Models?

Regards,

Eng
Anshika Varshney 1,910 Reputation points Microsoft External Staff Moderator

2025-10-14T18:39:22.1+00:00

Hello E T,

Did you get any chance to review the above response.

Thank you!
Anshika Varshney 1,910 Reputation points Microsoft External Staff Moderator

2025-10-21T12:23:42.93+00:00

Hello E T,

We haven’t heard from you on the last response and was just checking back to see if you have a resolution yet. In case if you have any resolution please do share that same with the community as it can be helpful to others. Otherwise, will respond with more details and we will try to help.

Thank you!
etan 0 Reputation points

2025-10-22T23:06:53.3633333+00:00

Hi Anshika Varshney,

Thanks. One further question I have -- what's the purpose of "Custom Template 3.1"? This container image is available for download from Microsoft Artifact Registry.

Custom Template 3.1 mcr.microsoft.com/azure-cognitive-services/form-recognizer/custom-template-3.1:latest

(https://free.blessedness.top/en-us/azure/ai-services/document-intelligence/containers/image-tags?view=doc-intel-3.1.0)

Regards,

Eng
SRILAKSHMI C 8,275 Reputation points Microsoft External Staff Moderator

2025-10-23T09:10:44.8566667+00:00

Hi etan,

I can see how the presence of the Custom Template 3.1 container image in Microsoft Artifact Registry might seem to suggest full custom model support in v3.1.

To clarify:

The “Custom Template 3.1” container image (mcr.microsoft.com/azure-cognitive-services/form-recognizer/custom-template-3.1:latest) is primarily intended for compatibility and evaluation scenarios related to template-based extraction models trained with the v3.0 API.

However, at this time, Azure Document Intelligence v3.1 containers do not support the training, deployment, or execution of new custom models created with v3.1 or newer APIs. The v3.1 “Custom Template” container exists to maintain backward compatibility for certain internal testing and migration use cases for example, to allow limited evaluation of template models built under v3.0 but it’s not a fully supported production container for custom models in the same way v3.0 was.

In short:

v3.0 Custom Template container supports full custom model inference (production-ready).

v3.1 Custom Template container available for limited backward compatibility and internal use; not officially supported for production custom model scenarios.

v3.1 Custom Neural / Custom model training or full deployment not supported in containers.

If you’re running custom (template or neural) models, the recommendation remains to continue using the v3.0 containers for now. Future container versions will consolidate custom model support under the Document Intelligence 4.0 framework, which aligns with the new unified API and container model.

Please keep monitor the Azure Updates page for announcements on when full custom model support becomes available in newer container versions.

Thank you!
Anshika Varshney 1,910 Reputation points Microsoft External Staff Moderator

2025-10-23T20:30:47.0866667+00:00

Hi etan,

Did you get any chance to review the above response.

Thank you!
etan 0 Reputation points

2025-10-24T02:39:52.5066667+00:00

Hi Anshika Varshney & SRILAKSHMI C,

Thank you for answering my questions.

1 answer

Your answer

Anshika Varshney 1,910 Reputation points Microsoft External Staff Moderator

2025-10-13T23:52:41.98+00:00

Hello E T,

Thank you for reaching out on the Microsoft Q&A.

Could you please check and provide us the requested details in the private message?
etan 0 Reputation points

2025-10-13T23:59:19.01+00:00

Hi Anshika Varshney,

Thanks for your response.

I prefer to discuss on this Q&A ticket if that's ok with you.

What is Microsoft official status for Document Intelligence v3.1 container support for Custom Models?

Regards,

Eng
Anshika Varshney 1,910 Reputation points Microsoft External Staff Moderator

2025-10-14T18:39:22.1+00:00

Hello E T,

Did you get any chance to review the above response.

Thank you!
Anshika Varshney 1,910 Reputation points Microsoft External Staff Moderator

2025-10-21T12:23:42.93+00:00

Hello E T,

We haven’t heard from you on the last response and was just checking back to see if you have a resolution yet. In case if you have any resolution please do share that same with the community as it can be helpful to others. Otherwise, will respond with more details and we will try to help.

Thank you!
etan 0 Reputation points

2025-10-22T23:06:53.3633333+00:00

Hi Anshika Varshney,

Thanks. One further question I have -- what's the purpose of "Custom Template 3.1"? This container image is available for download from Microsoft Artifact Registry.

Custom Template 3.1 mcr.microsoft.com/azure-cognitive-services/form-recognizer/custom-template-3.1:latest

(https://free.blessedness.top/en-us/azure/ai-services/document-intelligence/containers/image-tags?view=doc-intel-3.1.0)

Regards,

Eng
SRILAKSHMI C 8,275 Reputation points Microsoft External Staff Moderator

2025-10-23T09:10:44.8566667+00:00

Hi etan,

I can see how the presence of the Custom Template 3.1 container image in Microsoft Artifact Registry might seem to suggest full custom model support in v3.1.

To clarify:

The “Custom Template 3.1” container image (mcr.microsoft.com/azure-cognitive-services/form-recognizer/custom-template-3.1:latest) is primarily intended for compatibility and evaluation scenarios related to template-based extraction models trained with the v3.0 API.

However, at this time, Azure Document Intelligence v3.1 containers do not support the training, deployment, or execution of new custom models created with v3.1 or newer APIs. The v3.1 “Custom Template” container exists to maintain backward compatibility for certain internal testing and migration use cases for example, to allow limited evaluation of template models built under v3.0 but it’s not a fully supported production container for custom models in the same way v3.0 was.

In short:

v3.0 Custom Template container supports full custom model inference (production-ready).

v3.1 Custom Template container available for limited backward compatibility and internal use; not officially supported for production custom model scenarios.

v3.1 Custom Neural / Custom model training or full deployment not supported in containers.

If you’re running custom (template or neural) models, the recommendation remains to continue using the v3.0 containers for now. Future container versions will consolidate custom model support under the Document Intelligence 4.0 framework, which aligns with the new unified API and container model.

Please keep monitor the Azure Updates page for announcements on when full custom model support becomes available in newer container versions.

Thank you!
Anshika Varshney 1,910 Reputation points Microsoft External Staff Moderator

2025-10-23T20:30:47.0866667+00:00

Hi etan,

Did you get any chance to review the above response.

Thank you!
etan 0 Reputation points

2025-10-24T02:39:52.5066667+00:00

Hi Anshika Varshney & SRILAKSHMI C,

Thank you for answering my questions.

Answer 1

Hello E T,

thanks for reaching out. based on the details shared, this issue seems to be related to version compatibility in document intelligence containers. as per microsoft’s official documentation, custom models are not yet supported in the v3.1 containers. only the read, layout, id document, receipt, and invoice models are available in that version, which could explain why your custom model isn’t working as expected.

if you’re using a custom model (template or neural), please switch to the v3.0 container, which fully supports custom models. also, ensure the correct container image tag and environment variables are configured. if the issue continues, review the container logs for messages like “unsupported operation” or “model not recognized”, these usually confirm a version-related issue.

it would be great if you could share the container version tag, model type, and any error logs, so we can take a closer look. for now, i suggest continuing with the v3.0 container until microsoft adds custom model support to newer versions. future updates will be announced on the azure updates page and in the document intelligence documentation.

Reference:

hope this helps!

Anshika Varshney 1,910 Reputation points Microsoft External Staff Moderator

2025-10-24T13:04:53.57+00:00

Hi etan,

Thank you for sharing the update I appreciate you taking the time to confirm the resolution!

Since I’ve converted my earlier comment into an answer, could you please take a moment to mark it as Accepted? This helps others in the community with the same question find the solution more easily.

Share via

Are Custom models are supported by Document Intelligence v3.1 containers?

1 answer

Your answer