| title | Set up your Folder connection | ||
|---|---|---|---|
| description | This article provides information about how to create a Folder connection in Microsoft Fabric. | ||
| author | jianleishen | ||
| ms.author | jianleishen | ||
| ms.reviewer | jianleishen | ||
| ms.topic | how-to | ||
| ms.date | 03/20/2026 | ||
| ai-usage | ai-assisted | ||
| ms.custom |
|
This article outlines the steps to create a folder connection.
The Folder connector supports the following authentication types for copy and Dataflow Gen2 respectively.
| Authentication type | Copy | Dataflow Gen2 |
|---|---|---|
| Windows | √ | √ |
You can connect Dataflow Gen2 in Microsoft Fabric to Folder using Power Query connectors. Follow these steps to create your connection:
- Check capabilities to make sure your scenario is supported.
- Get data in Fabric.
- Connect to a folder.
[!INCLUDE folder-capabilities-supported]
[!INCLUDE get-data-data-factory-microsoft-fabric]
[!INCLUDE folder-connect-to-power-query-online]
The following table contains a summary of the properties needed for a Folder connection:
| Name | Description | Required |
|---|---|---|
| Gateway cluster name | Select the on-premises data gateway cluster that you use to connect to the custom data source. | Yes |
| Connection name | A name for your connection. | Yes |
| Connection type | Select Folder. | Yes |
| Full path | The root path of the folder that you want to copy. Use the escape character "" for special characters in the string. | |
| Authentication method | Go to Authentication. | Yes |
| Privacy level | The privacy level that you want to apply. Allowed values are None, Organizational, Private, and Public. | Yes |
For specific instructions to set up your connection in Manage connections and gateways, follow these steps:
-
From the page header in Data Integration service, select Settings :::image type="icon" source="./media/connector-common/settings.png"::: > Manage connections and gateways.
:::image type="content" source="./media/connector-common/manage-connections-gateways.png" alt-text="Screenshot showing how to open manage gateway.":::
-
Select New at the top of the ribbon to add a new data source.
:::image type="content" source="./media/connector-common/add-new-connection.png" alt-text="Screenshot showing the new page." lightbox="./media/connector-common/add-new-connection.png":::
The New connection pane shows up on the left side of the page.
:::image type="content" source="./media/connector-common/new-connection-pane.png" alt-text="Screenshot showing the New connection pane." lightbox="./media/connector-common/new-connection-pane.png":::
-
In the New connection pane, choose On-premises, and specify the following fields:
:::image type="content" source="media/connector-folder/connection-details.png" alt-text="Screenshot showing how to set up a new Folder connection.":::
- Gateway cluster name: Select the on-premises data gateway cluster that you use to connect to the custom data source.
- Connection name: Specify a name for your connection.
- Connection type: Select Folder for your connection type.
- Full path: Specify the root path of the folder. For example,
C:\myfolder.
-
Under Authentication method, select your authentication from the drop-down list and complete the related configuration. The Folder connector supports the following authentication types:
-
Under Privacy Level, select the privacy level that you want to apply.
-
Select Create to create your connection. Your creation is successfully tested and saved if all the credentials are correct. If not correct, the creation fails with errors.
This section lists the instructions for each authentication type supported by the Folder connector:
Fill in the required properties. You need to specify the Windows username and Windows password when using this authentication.
:::image type="content" source="media/connector-folder/windows-authentication.png" alt-text="Screenshot showing the Windows authentication method for Folder.":::
- Windows username: Specify the user name to use with Windows authentication. The format is
domain\<alias>. - Windows password: Specify the password for the user account.