Page tree
Skip to end of metadata
Go to start of metadata

File with Versioning Fields

File with versioning is the standard data type for storing attached files in Agiloft. File fields are highly configurable and can include check-in/check-out controls, versioning, OCR options, and other settings.

In record forms, file fields appear as as an input box with an Attach/Manage link to open the File wizard.

Adding files

There are two ways to add files:

  • You can drag the file onto the input box and drop it to upload.
  • Or, click Attach/Manage and use the dialog to browse for and upload a file.

Drag and drop files into the field

File Field Options


The Enable versioning? option adds a permission on the Permissions tab of the field wizard so that you can restrict which user groups can interact with versioned files. When versioning is turned on for a field, new options appear in the Attach / Manage wizard that allow you to update a file with a new version. Versioning is independent of whether the field may hold multiple files.

When a file has multiple version, a + icon appears next to the document. Clicking the plus + icon opens the document's version history.

When deleting versioned files, you will have options to delete all files, only old files, or only the most recent file.

Check-in / check-out restrictions

There are three levels of check-in/check-out restrictions which can be set for file fields: no restrictions, warnings only, or fully enforced check-in/check-out.  If check-in / check-out is enabled new options appear in the Attach / Manage wizard for these controls.

Attaching Multiple Files

You can choose whether the file field can hold multiple files or not by toggling the Allow the user to attach multiple files? setting. This works in conjunction with versioning, so it is possible to have multiple versioned files held in a single field (though such configuration is not typically recommended).

Minimum and Maximum File Size

You can set a minimum file size, maximum file size, or both if needed.

Allow Google Documents

Setting this option to Yes will show a section at the bottom on the Attach / Manage wizard to reference files stored in Google Drive instead of actually attaching a file.


Previous functionality allowed running optical character recognition on files as they were uploaded.  This functionality has been supplanted by the OCR Action type which runs when the record is saved, causing less interruption for the user. You can hide this option from users by updating the Deprecate Old File Options global variable. 

Direct File Editing

This option allows users with MS Office installed locally to open files from Agiloft for edit, then save directly back to the file field. Fore more on this topic, see Direct File Edit.

Restricting Attached File Types

A configuration script AttachedFileExtensionChecker.jar enables users to control the types of files that can be added to a file field by restricting file extensions. There are three options to configure file type restrictions:

  1. In the Admin Notes section of a file field, add a note defining the allowed file extensions, using the following format: <file_types_allowed>.docx, .jpg, .pdf</file_types_allowed>
    This tag can coexist with other note items, and has precedence over the other restriction methods. However, you will need to add this for each individual file field.
  2. Create the following new global variables:
    1. file_types_allowed - uses a comma-separated list of permitted file types.
    2. file_field_names_validate_types - uses a comma-separated list of file fields in which the file_types_allowed items are applied.
  3. Leave the script defaults as they are without configuration. The default settings are:
    1. Allowed file extensions: .docx, .jpg, .pdf, .jpeg
    2. File field name: attach_document

A copy of the script is attached here.