# New file

With the **New file** trigger, the action starts when the file is written on the VFS specified in the contract.

For example, when Data Mover in an input contract pulls a new file to a virtual path, contracts having the **New File** trigger on that virtual path will start.

The **New file** trigger requires a virtual path. 

**Execution Variable**

When executed, this trigger adds an execution variable named `file`, of type `FileDetail`. Its attributes are set based on the information sent from the event that initiated the trigger. 

For the **New file** trigger, Data Mover provides a set of **system workflow templates** that must be used in output contracts. You can find the complete list on the following page: [Workflow templates for output contracts → Trigger type: New file](/data-mover-1.21/workflow-templates/system-workflow-templates/workflow-templates-for-output-contracts.md#trigger-type-new-file). 


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.primeur.com/data-mover-1.21/workflow-templates/triggers/new-file.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.