---
title: Local File Trigger node documentation
description: Learn how to use the Local File Trigger node in n8n. Follow technical documentation to integrate Local File Trigger node into your workflows.
contentType: [integration, reference]
priority: high
---

# Local File Trigger node

The Local File Trigger node starts a workflow when it detects changes on the file system. These changes involve a file or folder getting added, changed, or deleted.

/// warning | Security considerations
The Local File Trigger node can introduce significant security risks in environments that operate with untrusted users. Because of this, the node is [disabled](/hosting/securing/blocking-nodes.md#exclude-nodes) by default starting from version 2.0.
///

/// note | Self-hosted n8n only
This node isn't available on n8n Cloud.
/// 

## Node parameters

You can choose what event to watch for using the **Trigger On** parameter.

## Changes to a Specific File

The node triggers when the specified file changes.

Enter the path for the file to watch in **File to Watch**.

## Changes Involving a Specific Folder

The node triggers when a change occurs in the selected folder.

Configure these parameters:

- **Folder to Watch**: Enter the path of the folder to watch.
- **Watch for**: Select the type of change to watch for.


## Node options

Use the node **Options** to include or exclude files and folders.

- **Include Linked Files/Folders**: also watch for changes to linked files or folders.
- **Ignore**: files or paths to ignore. n8n tests the whole path, not just the filename. Supports the [Anymatch](https://github.com/micromatch/anymatch) syntax.
- **Max Folder Depth**: how deep into the folder structure to watch for changes.

### Examples for Ignore

Ignore a single file:

```sh
**/<fileName>.<suffix>
# For example, **/myfile.txt
```

Ignore a sub-directory of a directory you're watching:

```sh
**/<directoryName>/**
# For example, **/myDirectory/**
```

## Templates and examples

<!-- see https://www.notion.so/n8n/Pull-in-templates-for-the-integrations-pages-37c716837b804d30a33b47475f6e3780 -->
[[ templatesWidget(page.title, 'local-file-trigger') ]]