> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Updating the built-in Document Definition

> Update the built-in Document Definition when a new FlexiCapture for Invoices version is released and see which fields, rules, and settings change or stay untouched.

FlexiCapture for Invoices ships with a built-in Document Definition designed specifically for processing invoices. Each time a new version of FlexiCapture for Invoices is released, the built-in Document Definition is also updated.

Users who created an invoice processing project in earlier versions of FlexiCapture for Invoices may update their Document Definition for invoices, preserving all their custom settings (the appearance of the data form, custom fields, rules, and so on) and benefiting from the improvements introduced in the newer version of FlexiCapture for Invoices.

| Component                   | Updated or added                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Remains unchanged                                                                                                                                                                                                                               |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Fields                      | The settings used for the main fields of the FlexiCapture for Invoices Document Definition are updated (see the [list of fields](/flexi-capture/invoice-reader/ir-extractable-fields)).<br /><br />Any new fields introduced in the new version of the FlexiCapture for Invoices Document Definition are added to the user's Document Definition.<br /><br />If the user has created a new field in their own Document Definition and there is a rule with the same name in the new version of the FlexiCapture for Invoices Document Definition, the update is interrupted and an error message is displayed. To continue with the update, the user needs to rename the conflicting field in the Document Definition. | The fields created by the user.                                                                                                                                                                                                                 |
| Rules                       | The settings used for the main rules of the FlexiCapture for Invoices Document Definition are updated (see the [list of rules](/flexi-capture/invoice-reader/ir-rules)).<br /><br />Any new rules introduced in the new version of the FlexiCapture for Invoices Document Definition are added to the user's Document Definition.                                                                                                                                                                                                                                                                                                                                                                                      | The rules created by the user. In the event of a conflict of rule names, the conflicting rules created by the user are automatically renamed (the suffix `_1` is added to each conflicting name).<br /><br />The user's scripts for all fields. |
| Data sets                   | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | The standard and the user's data sets.                                                                                                                                                                                                          |
| FlexiLayouts                | The main FlexiLayout.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | The additional FlexiLayout.                                                                                                                                                                                                                     |
| Invoice processing settings | Any new keywords, tax rates, and country- and language-specific field formats are added to the user's Document Definition.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | The invoice processing features enabled by the user.<br /><br />The countries and languages enabled by the user.<br /><br />Any keywords, tax rates, and field formats specified by the user.                                                   |
| Event handlers              | Any event handlers disabled in the user's Document Definition are updated.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Any event handlers enabled in the user's Document Definition.                                                                                                                                                                                   |
| External assemblies         | The standard assemblies included in the FlexiCapture for Invoices Document Definition.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Any assemblies added by the user.                                                                                                                                                                                                               |

The export settings, the data form, and the localization of the Document Definition remain unchanged.

## Update the Document Definition

<Steps>
  <Step title="Open the Document Definitions dialog box">
    On the main menu, click **Project → Document Definitions...**. The **Document Definitions** dialog box opens, where you can manage your Document Definitions.

    <Note>
      We recommend backing up your Document Definition before updating it. To create a backup copy, select it in the list and click **Duplicate**.
    </Note>
  </Step>

  <Step title="Update the Document Definition">
    Select the Document Definition in the list and click **Update**.
  </Step>

  <Step title="Publish the changes">
    Click **Publish** to publish the changes.
  </Step>
</Steps>

If you want to discard the changes made by the update, click **Discard Changes**.

## Possible errors and warnings

Your Document Definition is updated even if error messages and warnings are displayed during the updating process. You can open, edit, and publish your updated Document Definition, or you can discard the changes made by the update.

If an error occurs when you update your Document Definition, the cause of the error is indicated in the corresponding error message. The changes that cause the error are not included in the updated Document Definition.

If you see error messages and warnings while updating your Document Definition, this means that some manual editing is required. We do not recommend using a Document Definition that was updated with errors and warnings.