Cloud File Detection
The cloud file detection and conversion lets Designer automatically detect when a file path points to a file stored in a supported cloud-synced folder and convert the path to use the corresponding cloud connection. This feature makes it easier to work with files stored in cloud storage services without manually replacing local file paths with cloud connections.
Cloud-synced files have local copies on your computer, so workflows might reference them through local file paths that aren't accessible in Alteryx One. Converting these paths to cloud connections allows workflows to access files directly from the cloud storage service.
When you add a file to the Input Data or Output Data tool by dragging it onto the canvas or browsing to it, Designer identifies its cloud storage location and configures the tool to access the file through the corresponding cloud connection rather than its local file path.
Important
This feature is available as a preview in Designer 2026.4 and supports OneDrive only.
Set Up Cloud File Detection and Conversion
To set up and start using cloud file detection and conversion, perform the following steps:
Prerequisites
Make sure that the following prerequisites are met before proceeding:
Designer 2026.4 or later.
A supported cloud storage service account, signed in and synchronising files to your computer. The current preview supports OneDrive.
DCM enabled in Designer. Go to Options > User Settings > Edit User Settings and select Override DCM Settings to enable it.
Enable Cloud-Synced File Conversion
To enable the file conversion:
In Designer, go to Options > User Settings > Edit User Settings.
On the General tab, select Automatically convert cloud-synced file paths to cloud connections (PREVIEW).
Select Save.
To keep local file paths exactly as you enter them, clear the option.
Add Cloud-Synced File
Add a file from your synced connector folder. You can drag a file onto the canvas or browse to it from the Input Data or Output Data tool.
Designer checks whether a supported cloud connection is available for the file.
If one connection matches, Designer uses it without prompting you.
If several connections match, Designer uses the one that matches your signed-in connector account. If it cannot identify a match, select the connection you want.
If no connection matches, Designer prompts you to create a connection.
Select Create Connection.
Follow the prompts to install the required connector, if necessary, and authenticate with Microsoft. After signing in, Designer creates a connection.
For an Input Data tool, Designer sets default file options. For an Output Data tool, set the file options in the connector window that opens.
To use a different authentication method, select View Connection in the window or the notification.
Note
If you cancel the setup, the connector installation fails, or authentication does not complete, Designer retains the original local file path so your workflow can continue to run on your computer.
Default Input File Options
When Designer configures an Input Data tool, it uses these defaults. You can change them in the tool.
CSV: UTF-8, comma delimiter, first row has headers, field length 254.
Excel (XLSX, XLSM): the first sheet.
Save Workflow to Alteryx One
In Designer, select File > Save As > Alteryx One.
Designer converts connector-synced files that have a matching connection. They appear under Dependencies Available in Cloud.
Files that still need a connection appear under Connect via [Connector] . Since the preview only supports OneDrive, the connection appears under Connect via OneDrive. Select Connect All. Designer runs the same connection steps for each file.
Review any warnings. Files that cannot be connected keep their local paths and remain in the list.
Select Save.
Designer converts a copy of the workflow. Your open workflow only changes when the save succeeds. If you cancel, nothing changes.
Limitations
The current preview supports OneDrive.
Only individual files are converted. Folders, wildcards, and dynamic inputs are not supported.
Typing or editing a path in the Input Data or Output Data tool does not trigger detection. You have to browse to the file or drag it onto the canvas.
Designer creates the connection using Alteryx's built-in Microsoft app. To use your own Azure app or a service principal, create the connection in Data Connection Manager.
Designer waits up to 2 minutes for you to sign in. If you take longer, select Retry or Authenticate.
During Save to Alteryx One, macros are not converted.
If multiple connections are available and Designer cannot identify an exact account match, you must select a connection.
Conversion cannot be undone from Save to Alteryx One. On the canvas, Undo reverses a drag-and-drop action, including its conversion.