Frequently asked questions

This content applies to: checkmark v4.0 (preview) checkmark v3.1 (GA) checkmark v3.0 (GA) checkmark v2.1 (GA)

Azure AI Document Intelligence is a cloud-based service that uses machine-learning models to extract key/value pairs, text, and tables from your documents. The returned result is a structured JSON output. Document Intelligence use cases include automated data processing, enhanced data-driven strategies, and enriched document search capabilities.


Are Azure AI Document Intelligence and Azure AI Form Recognizer the same service?


Azure AI Document Intelligence and Azure AI Form Recognizer are the same service. The service was renamed from Azure AI Form Recognizer to Azure AI Document Intelligence in July 2023. The service provides the same capabilities and features as before the renaming.

  • Pricing changes: There are no changes to pricing. The names Cognitive Services and Applied AI Services continue to be used in Azure billing, cost analysis, price lists, and price APIs.

  • Breaking changes: There are no breaking changes to APIs or client libraries. REST APIs and SDK versions 2024-02-29-preview, 2023-10-31-preview, and later are renamed document intelligence.

Does Document Intelligence integrate with other Microsoft services?


Document Intelligence integrates with the following services:

AI capabilities

Can I use Document Intelligence with generative AI for document processing?


You can use a document generative AI solution to chat with your documents, generate captivating content from those documents, and access Azure OpenAI Service models on your data.

  • With Azure AI Document Intelligence and Azure OpenAI combined, you can build an enterprise application to seamlessly interact with your documents by using natural languages. You can easily find answers, gain valuable insights, and generate new and engaging content from existing documents.

  • You can find more details in the technical community blog.

Can Document Intelligence help with semantic chunking within documents for retrieval-augmented generation?


Document Intelligence can provide the building blocks to enable semantic chunking. Semantic chunking is a key step in retrieval-augmented generation (RAG) to ensure its efficient storage and retrieval.

  • Document Intelligence provides a layout model that segments documents into coherent units based on their semantic content.

  • You can then export the obtained information to Markdown format, so that you can customize your semantic segmentation strategy based on the available building blocks.

For more information, see overview of RAG in Document Intelligence

Document Intelligence Studio

Do I need specific permissions to access Document Intelligence Studio?


You need an active Azure account and subscription with at least a Reader role to access Document Intelligence Studio.

For document analysis and prebuilt models, here are the role requirements for user scenarios:

For custom model projects, here are the role requirements for user scenarios:

  • Basic

    • Cognitive Services User: You need this role for a Document Intelligence or Cognitive Services multiple-service resource to train a custom model or analyze with trained models.

    • Storage Blob Data Contributor: You need this role for a storage account to create project and label data.

  • Advanced

    • Storage Account Contributor: You need this role for the storage account to set up cross-origin resource sharing (CORS) settings. It's a one-time effort if you reuse the same storage account.

    • Contributor: You need this role to create a resource group and resources. Contributor or Storage Account Contributor role doesn't give you access to use your Document Intelligence resource or storage account if local (key-based) authentication is disabled. You still need the basic roles (Cognitive Services User and Storage Data Blob Contributor) to use the functions on Document Intelligence Studio.

For more information, see Microsoft Entra built-in roles and the sections about Azure role assignments in the Document Intelligence Studio quickstart.

Can I process documents with more than two pages in Document Intelligence Studio?

Yes, for paid-tier resources.

No, for free-tier resources.

  • For free-tier (F0) resources, only the first two pages are analyzed whether you're using Document Intelligence Studio, the REST API, or client libraries.

  • If you want to analyze all pages in a document, change to a paid (S0) resource. In Document Intelligence Studio, select the Settings (gear) button, select the Resources tab, and check the price tier to use for analyzing your documents.

Can I change directories or subscriptions in Document Intelligence Studio?


  • To change a directory in Document Intelligence Studio, select the Settings (gear) button. Under Directory, select the directory from the list, and then select Switch Directory. Sign in again after you switch the directory.

  • To change a subscription or resource, go to the Resource tab under Settings.

Can I use Document Intelligence Studio with a resource that is configured with a firewall or virtual network?


If your Document Intelligence resource is configured with a firewall or virtual network, you need to add the dedicated IP address to the firewall allowlist for your Document Intelligence resource.

Can I reuse or customize the labeling experience from Document Intelligence Studio and build it into my own application?


The labeling experience from Document Intelligence Studio is open sourced in the Toolkit repo.

Are there separate URL endpoints for Document Intelligence sovereign cloud regions?


Document Intelligence Studio has separate URL endpoints for sovereign cloud regions:

App development

Can I develop applications using Azure AI Document Intelligence using the latest development options?


Document Intelligence offers the latest development options within the following platforms:

Can I migrate my application to the latest version of Document Intelligence?


The following table provides links to detailed instructions for migrating to the newest version of Document Intelligence:

Language/API Migration guide
C#/.NET 4.0.0
Java 4.0.0
JavaScript 4.0.0
Python 3.2.0

Can I specify a range of pages to be analyzed in a document?


Use the pages parameter (supported in v2.1, v3.0, and later versions of the REST API) and specify pages for multiple-page PDF and TIFF documents. Accepted input includes the following ranges:

  • Single pages. For example, if you specify 1, 2, pages 1 and 2 are processed.
  • Finite ranges. For example, if you specify 2-5, pages 2 to 5 are processed.
  • Open-ended ranges. For example, if you specify 5-, all the pages from page 5 are processed. If you specify -10, pages 1 to 10 are processed.

You can mix these parameters together, and ranges can overlap. For example, if you specify -5, 1, 3, 5-10, pages 1 to 10 are processed.

The service accepts the request if it can process at least one page of the document. For example, using 5-100 on a five-page document is a valid input that means page 5 is processed.

If you don't provide a page range, the entire document is processed.

Do you recommend using Document Intelligence Studio rather than the FOTT Sample Labeling tool for my project?


We recommend Document Intelligence Studio most of the time because it can reduce your time for configuring Document Intelligence resources and storage services.

Only consider using the Form Testing Tool (FOTT) for the following scenarios:

Are there best practices to mitigate throttling?


Document Intelligence uses autoscaling to provide the required computational resources on demand, while keeping customer costs low. To mitigate throttling during autoscaling, we recommend the following approach:

  • Implement retry logic in your application.

  • If you find that you're being throttled on the number of POST requests, consider adding a delay between the requests.

  • Increase the workload gradually. Avoid sharp changes.

  • Create a support request to increase transactions per second (TPS) limit.

Learn more about Document Intelligence service quotas and limits.

Custom models

Can I improve an estimated accuracy score for a custom model?


Variances in the visual structure of your documents can influence the accuracy of a model. Here are some tips:

  • Include all variations of a document in the training dataset. Variations include different formats; for example, digital versus scanned PDFs.

  • Separate visually distinct document types and train different models.

  • Make sure that you don't have extraneous labels.

  • For signature and region labeling, don't include the surrounding text.

For more information, see Accuracy and confidence scores.

Can I retrain a custom model?


  • Document Intelligence doesn't have an explicit retrain operation. Each train operation generates a new model.

  • If you find that your model needs to retrain, you can add more samples to your training dataset and train a new model.

  • You can also create a new model to compose with your original model as follows:

    1. Create a dataset for your new template.

    2. Label and train a new model.

    3. Validate that the new model performs well for your specific document types.

    4. Compose your new model with the existing model into a single endpoint. Document Intelligence can then determine the best model for each document to be analyzed.

    For more information, see composed models.

Can I move my trained models from one environment (like beta) to another (like production)?


You can use the Copy API to copy custom models from one Document Intelligence account into others that exist in any supported geographical region. For detailed instructions, see Disaster recovery.

The copy operation is limited to copying models within the specific cloud environment where you trained the model. For instance, copying models from the public cloud to the Azure Government cloud isn't supported.

Storage account

Is there an expiry time for the shared access signature (SAS) token that I for my storage account authentication?


When you create a shared access signature (SAS), the default duration is 48 hours. After 48 hours, you need to create a new token.

Consider setting a longer duration period for the time that you're using your storage account with Document Intelligence.

Can Document Intelligence access data in my storage account if it is behind a virtual network or firewall?

No, not directly.

Document Intelligence can't access your storage account if it's protected by a virtual network or firewall.

However, private Azure storage account access and authentication support managed identities for Azure resources. When you use a managed identity, the Document Intelligence service can access your storage account by using an assigned credential.

If you intend to analyze your private storage account data by using FOTT, you must deploy the tool behind the virtual network or firewall.

Learn how to create and use a managed identity for your Document Intelligence resource.


Is there a difference between disconnected and connected containers?


Although the model capabilities are the same for connected and disconnected containers, the billing and connectivity methods differ:

  • Connected containers send billing information to Azure by using a Document Intelligence resource on your Azure account. With connected containers, internet connectivity is required to send billing information to Azure. Document Intelligence connected containers send billing information to Azure by using a Document Intelligence resource on your Azure account. Connected containers don't send customer data, such as the image or text that's being analyzed, to Microsoft. For an example of the information that connected containers send to Microsoft for billing, see the Azure AI container FAQ.

  • Disconnected containers enable you to use APIs that are disconnected from the internet. Billing information isn't sent via the internet. Instead, Charges are based on a purchased commitment tier. Currently, disconnected container usage is available for Document Intelligence custom and invoice models.

Can I use local storage for the Document Intelligence Sample Labeling Tool (FOTT) container?


FOTT has a version that uses local storage. The version needs to be installed on a Windows machine. You can install it from this location.

On the project page, specify the label folder URI as /shared or /shared/sub-dir if your labeling files are in a subdirectory. All other Document Intelligence Sample Labeling Tool behavior is the same as the hosted service.

Is there a best practice for scaling up?


For asynchronous calls, you can run multiple containers with shared storage. The container that's processing the POST analyze call stores the output in the storage. Then, any other container can fetch the results from the storage and serve the GET calls. The request ID isn't tied to a container.

For synchronous calls, you can run multiple containers, but only one container serves a request. Because it's a blocking call, any container from the pool can serve the request and send the response. Here, only one container is tied to a request at a time, and no polling is required.

Can I set up containers with shared storage?


The containers use the Mounts: Shared property while starting up for specifying the shared storage to store the processing files. To see the use of this property, refer to the containers documentation.

Security and privacy

Does Document Intelligence store my data?

Yes, briefly.

For all features, Document Intelligence temporarily stores data and results in Azure Storage in the same region as the request. Your data is then deleted within 24 hours from the time that you submit an analyze request.

Learn more about data, privacy, and security for Document Intelligence.

For trained custom models, the interim outputs after analysis and labeling are stored in the same Azure Storage location where you store your training data. The trained custom models are stored in Azure Storage in the same region, and are logically isolated with your Azure subscription and API credentials.

More help and support

Are there other resources available to provide solutions to Azure AI Document Intelligence questions?


Microsoft Q & A is the home for technical questions and answers at Microsoft. You can filter queries that are specific to Document Intelligence.

Can I provide direct feedback if the service doesn't recognize specific text, or recognizes it incorrectly, when I'm labeling documents?


We continually update and improve the Document Intelligence models. You can email the Document Intelligence team. If possible, share a sample document with the issue highlighted.