- Overview
- Process modeling
- Process implementation
- Process operations
- Process monitoring
- Process optimization
- Reference information

Maestro user guide
Using files in Maestro
In UiPath Maestro™, files are managed through Data Fabric (previously called Data Service). Every time a file is downloaded from a source (such as an email attachment or a cloud storage provider), the file is uploaded to an entity in Data Fabric that supports file storage.
The file is then referenced using a Data Fabric reference, a triplet containing:
- EntityName
- RecordId
- FieldName
This reference allows the file to be used anywhere in your agentic process.
Before using files in Maestro, make sure that:
- Data Fabric is enabled in your organization or tenant.
- An entity with a file-supporting field is configured.
No additional fields are required beyond those automatically filled by Data Fabric, when a record is created.
This example shows how to download a file from Box, and send it as an email attachment.
- Download the file
- Configure a Send Task to run a Download File activity from the Box connector.
- Select the file you want to download.
- Set the File resource output using the Data Fabric editor. Choose the Entity and Field that support files.
When executed, the activity will return a Data Fabric reference (EntityName
,RecordId
,FieldName
) pointing to the new file record in Data Fabric. - Send the file by email
- Configure another Send Task using the Outlook connector's Send Email activity.
- Attach the file by referencing the RecordId from the previous step in the Data Fabric editor.
After testing, you will find the RecordId available in the workflow variables.
You can also verify the file exists in the Data Fabric application by searching for the RecordId.
- In Maestro, files are supported exclusevily through Data Fabric.
- If a file already exists in Data Fabric, you can reuse it by adding its Data Fabric reference.