Salesforce Docs Portal

File Connector Release Notes

Support Category: Select

Guide: File Connector User Guide

1.5.7

September 4, 2026

What’s New

  • This release includes general security fixes.

Compatibility

Software Version

Mule

4.1.1 and later

OpenJDK

8, 11, and 17

1.5.6

July 24, 2026

What’s New

  • This connector version requires Mule runtime 4.6.22 or later if you’re using Mule 4.6.x, or Mule runtime 4.9.9 or later if you’re using Mule 4.9.x. If you prefer not to upgrade your Mule runtime, use the connector version released immediately after this one.

Compatibility

Software Version

Mule

4.1.1 and later

OpenJDK

8, 11, and 17

Fixed Issues

Issue Resolution ID

These libraries are upgraded to address reported security vulnerabilities:

  • The Commons IO library is upgraded to version 2.22.0.

  • The Apache Commons Lang library is upgraded to version 3.20.0.

W-23441637

1.5.5

October 30, 2025

Compatibility

Software Version

Mule

4.1.1 and later

OpenJDK

8, 11, and 17

Fixed Issues

Issue Resolution ID

The mule-module-file-extension-common library is upgraded to version 1.4.5 to address the CVE-2024-47554 security vulnerabilities.

W-20000386

1.5.4

September 16, 2025

Compatibility

Software Version

Mule

4.1.1 and later

OpenJDK

8, 11, and 17

Fixed Issues

Issue Resolution ID

These libraries are upgraded to address reported security vulnerabilities:

  • The apache-common library is upgraded to version 3.18.0.

  • The commons-io library is upgraded to version 2.20.0.

W-19549266

1.5.3

March 18, 2025

Compatibility

Software Version

Mule

4.1.1 and later

OpenJDK

8, 11, and 17

Fixed Issues

Issue Resolution ID

The commons-io library is upgraded to version 2.18.0 to address reported security vulnerabilities.

W-17919658

1.5.2

December 14, 2023

What’s New

  • This connector is now compatible with Java 17.

Compatibility

Software Version

Mule

4.1.1 and later

OpenJDK

8, 11, and 17

1.5.1

May 8, 2023

Compatibility

Software Version

Mule

4.1.1 and later

OpenJDK

8

Fixed Issues

Issue Resolution ID

The On New or Updated File source now performs a file size check when the Redelivery Policy is not enabled.

W-12673321

The On New or Updated File source now performs a file size check three times instead of two times.

W-12705259

1.5.0

Aug 19, 2022

Compatibility

Software Version

Mule

4.1.1 and later

OpenJDK

8

Fixed Issues

Issue ID

The On New or Updated File operation now provides the Overwrite field, which enables you to overwrite the target file when the destination file has the same name.

W-11427407

1.4.1

July 07, 2022

Compatibility

Software Version

Mule

4.1.1 and later

OpenJDK

8

Fixed Issues

Issue ID

The Write operation now throws a FILE:ILLEGAL_PATH error when the file name is not valid.

W-11352447

1.4.0

June 30, 2022

What’s New

  • The List operation now enables you to limit and sort the number of files returned using the Subset field.

Compatibility

Software Version

Mule

4.1.1 and later

OpenJDK

8

1.3.5

May 26, 2022

Compatibility

Software Version

Mule

4.1.1 and later

OpenJDK

8

Fixed Issues

Issue ID

The Overwrite flag for File Connector Copy operation now works correctly.

W-10688508

1.3.4

December 14, 2020

Minimum Mule Version

Mule 4.1.1

Fixed Issues

  • Improved stability (FILEC-59).

1.3.3

August 31, 2020

Minimum Mule Version

Mule 4.1.1

Fixed Issues

  • Fixed an issue in which the File Connector Listener operation post action was not able to rename a file. (MULE-17446)

  • Removed the spring repo declaration in POM files. (MULE-18023)

  • Upgraded the file common version.

1.3.2

October 15, 2019

Minimum Mule Version

Mule 4.1.1

Fixed Issues

  • Fixed a bug that made the streams created by the connector have the need to be finalized when disposed. (MULE-17521)

  • Updated Ant version to 1.10.5 (MULE-16646)

1.3.1

August 8, 2019

Minimum Mule Version

Mule 4.1.1

Fixed Issues

  • File List operation and the File listener now only open File channels when retrieving the content of a file. (MULE-16655)

  • Fixed a race condition in the File listener that could led to File channels not being closed. (MULE-17260)

1.3.0

July 15, 2019

Minimum Mule Version

Mule 4.1.1

Features

  • The updatedInTheLast, notUpdatedInTheLast, timeUnit parameters have been added to the File Matcher. These parameters enable you to have a List or Listener operation that filters files that are still being written to, or are too old.

Fixed Issues

  • Added (Not) Updated in the last…​ capability to File Matcher. (MULE-17103)

1.2.4

May 10, 2019

Minimum Mule Version

Mule 4.1.1

Fixed Issues

  • The List operation fails to list files in a directory when encountering a file without read permissions. (MULE-16819)

  • In Windows, the List operation fails to list files in a directory where a file has been deleted just before the list operation is executed. (MULE-16827)

  • NoSuchFileExceptions with file listeners in clustered environment. (MULE-16766)

  • File Listener with watermark skips a file. (MULE-15792)

1.2.3

April 29, 2019

Minimum Mule Version

Mule 4.1.1

Fixed Issues

  • The List operation failed when listing a directory that contained a file that had been moved or deleted. (MULE-16766)

  • The listener stopped polling when failing to list a file. Now the connector either lists all files, or fails entirely. (MULE-15792)

1.2.2

April 3, 2019

Minimum Mule Version

Mule 4.1.1

Fixed Issues

  • File Connector should not gather attributes twice on the list operation. (MULE-16356)

  • File Connector doesn’t fail when a file lock is not obtained. (MULE-16353)

  • Removed Guava dependency. (MULE-14275)

  • Upgraded File Commons dependency to 1.2.1.

  • Upgraded Commons IO to 2.6.

1.2.1

November 8, 2018

Minimum Mule Version

Mule 4.1.1

Fixed Issues

  • File Directory listener leaks open files. (MULE-15687)

  • Directory parameter should have path support. (MULE-14128)

1.2.0

August 14, 2018

Minimum Mule Version

Mule 4.1.0

Features

  • You can make use of timeBetweenSizeCheck to prevent the connector from processing files while they are being written.

Fixed Issues

  • File getting partial files. (MULE-14881)

  • file:listener does not delete source file when moving to a file that already exists. (MULE-15030)

  • File Polling Source does not communicate their Attributes correctly. (MULE-15351)

  • When File connector listeners are configured to move to a directory, auto-delete deletes files but does not move them. (MULE-15448)

  • Encoding parameter should be removed from the write operation. (MULE-15503)

1.1.3

May 7, 2018

Minimum Mule Version

Mule 4.1.0

Features

  • Fixed an issue that happened when using a filter by filenamePattern, failing to search files recursively in folders.

Fixed Issues

  • File Connector does not check for files recursively if a filenamePattern is given. (MULE-14863)

1.1.2

March 14, 2018

Minimum Mule Version

Mule 4.1.0

Fixed Issues

  • Connectors doesn’t communicate correctly if their POJOs properties are nulleable or not. (MULE-14701)

1.1.1

February 2, 2018

Fixed Issues

  • file:listener has undescriptive display name. (MULE-14584)

1.1.0

January 19, 2018

Features

This release includes the following enhancements, changes, and fixes:

  • Added a message source that automatically polls for new files, while handling clustering, idempotency, post actions and watermark automatically.

Upgrade Requirements

Mule 4.1

Fixed Issues

  • Support processing files in all nodes of the cluster as we did in 3.x. (MULE-14128)

See Also