---
schema_version: "1"
id: eed601eb49ec44ddd8355ecd6fa2a37be2a5e56d31566632dded08fa766b6b91
title: File Connector Release Notes
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/release-notes/connector/connector-file.md
canonical_url: https://docs.mulesoft.com/release-notes/connector/connector-file
source_site: docs.mulesoft.com
content_type: documentation
content_hash: fe218edb0c9f066df8e92f204a8b34312fa72ec870e9734b622838e333ef21fc
description: MuleSoft Documentation Site
latest: true
---
---
product: Release Notes
version: master
---

# File Connector Release Notes

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

Support Category:
[Select](https://www.salesforce.com/en-us/wp-content/uploads/sites/4/documents/legal/Agreements/versioning-back-support-policy.pdf)

Guide: [File Connector User Guide](https://docs.mulesoft.com/file-connector/latest/)

## 1.5.7

**September 4, 2026**

### What’s New

- This release includes general security fixes.

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.1 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8, 11, and 17</p></td></tr></tbody></table>

## 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

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.1 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8, 11, and 17</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue Resolution</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>These libraries are upgraded to address reported security vulnerabilities:</p></div><div><ul><li><p>The Commons IO library is upgraded to version 2.22.0.</p></li><li><p>The Apache Commons Lang library is upgraded to version 3.20.0.</p></li></ul></div></div></td><td><div><div><p>W-23441637</p></div></div></td></tr></tbody></table>

## 1.5.5

**October 30, 2025**

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.1 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8, 11, and 17</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue Resolution</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>The <code>mule-module-file-extension-common</code> library is upgraded to version 1.4.5 to address the <code>CVE-2024-47554</code> security vulnerabilities.</p></div></div></td><td><div><div><p>W-20000386</p></div></div></td></tr></tbody></table>

## 1.5.4

**September 16, 2025**

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.1 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8, 11, and 17</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue Resolution</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>These libraries are upgraded to address reported security vulnerabilities:</p></div><div><ul><li><p>The <code>apache-common</code> library is upgraded to version 3.18.0.</p></li><li><p>The <code>commons-io</code> library is upgraded to version 2.20.0.</p></li></ul></div></div></td><td><div><div><p>W-19549266</p></div></div></td></tr></tbody></table>

## 1.5.3

**March 18, 2025**

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.1 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8, 11, and 17</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue Resolution</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>The <code>commons-io</code> library is upgraded to version 2.18.0 to address reported security vulnerabilities.</p></div></div></td><td><div><div><p>W-17919658</p></div></div></td></tr></tbody></table>

## 1.5.2

**December 14, 2023**

### What’s New

- This connector is now compatible with Java 17.

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.1 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8, 11, and 17</p></td></tr></tbody></table>

## 1.5.1

**May 8, 2023**

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.1 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue Resolution</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>The <strong>On New or Updated File</strong> source now performs a file size check when the Redelivery Policy is not enabled.</p></div></div></td><td><div><div><p>W-12673321</p></div></div></td></tr><tr><td><div><div><p>The <strong>On New or Updated File</strong> source now performs a file size check three times instead of two times.</p></div></div></td><td><div><div><p>W-12705259</p></div></div></td></tr></tbody></table>

## 1.5.0

**Aug 19, 2022**

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.1 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>The <strong>On New or Updated File</strong> operation now provides the <strong>Overwrite</strong> field, which enables you to overwrite the target file when the destination file has the same name.</p></div></div></td><td><div><div><p>W-11427407</p></div></div></td></tr></tbody></table>

## 1.4.1

**July 07, 2022**

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.1 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>The <strong>Write</strong> operation now throws a <code>FILE:ILLEGAL_PATH</code> error when the file name is not valid.</p></div></div></td><td><div><div><p>W-11352447</p></div></div></td></tr></tbody></table>

## 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

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.1 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8</p></td></tr></tbody></table>

## 1.3.5

**May 26, 2022**

### Compatibility

<table><colgroup><col> <col></colgroup><thead><tr><th>Software</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.1.1 and later</p></td></tr><tr><td><p>OpenJDK</p></td><td><p>8</p></td></tr></tbody></table>

### Fixed Issues

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>The <strong>Overwrite</strong> flag for File Connector <strong>Copy</strong> operation now works correctly.</p></div></div></td><td><div><div><p>W-10688508</p></div></div></td></tr></tbody></table>

## 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

- [Salesforce Help](https://help.salesforce.com)

- [MuleSoft Services](https://www.mulesoft.com/support-and-services)

- [Known Issues](https://help.salesforce.com/s/issues)