Q: How can I be sure that a document was refiled?

A: View the document's timeline to see changes from a completed Refile Service event. Security and metadata (profile) updates are independent refile events and are listed separately.

Q: Does importing a new document or filing an email trigger a refile event?

A: Yes. Document import event triggers a refile only for that document.  No other items under the folder are examined. For example, if you import a document into a folder with 100 documents, this will NOT trigger the refile for all 100 documents.

Q: In cases where users can perform client-side refile and/or perform bulk security updates, how does the Refile Service behave?

A: Refer to the following table to understand the differences in behavior:

User-initiated security updates

Refile Service

Security Update Initiator


Event-driven Service.

Security Updates performed by

End-users on files that they have Full Access to.

Refile Service account must be run with an NRTADMIN account to allow security updates to all content within the library.

Security changes tracked in the audit

As the security update is triggered by end-users, the changes are only applied to documents that they have full access to. 

Changes are performed as Admin user, using Refile Service.
Updates are done by the Refile Service account, which updates the security for all the files.

Security rules

End-users have granular control and can select options at the beginning of the bulk operation. Options provided:

  • How to update security for private files.
  • To update security for all the versions of the selected document or only the selected version.
  • Update security for referenced files or not.

Admins decide how to apply security by configuring the options in the backend. For more information, refer to Configuring Refile.

Security and metadata changes

Only updates the security of the selected files.

Can be configured to update metadata, security, or both.

Number of files impacted by a security change

Depends on how many files are selected by users (maximum of 5000 files can be selected).

Applies to all the files within a folder.

Objects impacted (files/folders/workspaces)

Only applies to files that are selected by users for security updates.

: Container security update (Folders & W
orkspaces) is being targeted for a future release. 

Since this is event-driven, a security update at the workspace impacts all the folders and files within the workspace.


End-users are provided with a report at the end of the process with success, skips, or any exceptions.

No notifications are available to end-users.

Reference links for more information

 Editing user/group permissions of items in bulk


Q: I added a user to a folder or workspace and they cannot access it items within it. How long does this take?

A: Adding a user to a folder or workspace will trigger a refile. After making a change, such as adding users or permissions, it may take several minutes for it to complete. However, in cases where a large number of events are in the Refile queue, or extensive changes during the refile processing, this may take a few hours.

Q: I changed the Refile configuration in Control Center. When will I see the changes take effect?

A: The Refile Service checks for updates to the configuration after it completes all the activities in its queue on a 15 minute interval. Depending on your environment, changes to your Refile configuration may take up to several hours to populate across all regions.

Q: Does a refile event itself cause another refile event?

A: No.

Q: How are moves and copied handled?

A: When an object is moved or copied in iManage Work, the metadata properties of the object are automatically updated based on the new location. This update is performed directly within iManage Work, and not by the Refile Service.

After the object is moved or copied, the Refile Service subsequently checks both the metadata and security properties of the object and any children, and aligns these properties with the new location according to all Refile Service rules and configuration.

Q: Why is my document not refiled?

A: Check the following:

  • Verify that the Refile Service is running (on-premises deployments only).

  • Verify that every parent folder is eligible for refile.

  • Verify that the document is checked in and not locked.

  • Verify that the document is not a restricted document.

  • Review the conditions that trigger a refile event.

  • Review the conditions that do not trigger a refile event.

Q: Why is my workspace, folder, or document not refiled?

A: Check the following:

  • Verify that the Refile Service is running (on-premises deployments only).

  • Verify that the Refile Service is enabled for that library.

  • Verify that refile security or refile metadata is enabled.

  • Review your exclusion and inclusion rules to confirm they are configured correctly.

Q: Why were all refile-eligible metadata fields updated on an object when not all metadata fields were updated on the object's parent?

A: When changing workspace or folder metadata, the metadata refile operation updates all eligible metadata fields for an object when a metadata event is triggered. Therefore, each refile eligible metadata field is updated, including fields that might not have changed. For example, if a change is made to metadata field custom3 for a workspace, all refile eligible fields (potentially custom1 through custom30) for a document could be updated. This results in the document's metadata fields aligning with the metadata values for the workspace.