Manage Dependencies for Workspace Execution
Review and resolve workflow dependencies before you save a Designer workflow package to Alteryx One. A complete package helps ensure that Workspace Execution can access the files, macros, and connections required to run your workflow.
Before You Start
Link Designer to your Alteryx One workspace.
Confirm that Workspace Execution is enabled for the workspace.
Configure workflow connections through Data Connection Manager (DCM).
Review Workspace Execution compatibility requirements for your tools, connectors, drivers, and engine.
To have Designer convert OneDrive files to cloud connections when you save, keep Automatically Convert Cloud-Synced Files Path To Connections selected in Options > User Settings > General. It is selected by default.
Note
To run a Designer workflow with Workspace Execution, save it as a Designer Workflow Package (.yxzp).
Manage Workflow Dependencies
Open the workflow in Designer.
Select File > Save As > Alteryx One.
Enter an asset name in the Name field.
From the Asset Type dropdown, select Designer Workflow Package (.yxzp) and select a location in the Alteryx One Library.
In the Dependencies section, review the dependency info banner. Select Manage to open the Manage Dependencies dialog and address any dependency issues that are identified.
Review the dependencies grouped by tool.
Note
Tool names appear as headers in the same order as the tools on the canvas. Dependencies that are already connected to the cloud, such as cloud-connected inputs and outputs, are not listed. Files that Designer converted from OneDrive paths to connections are treated as connected. For more details, go to Convert OneDrive Files to Cloud Connections.
Select each dependency that you want to include in the package. Clear a dependency to omit it. To return the checkboxes to their initial state, select Restore Default Selection.
Resolve any alerts shown in the dialog. Refer to Dependency Alerts below for details.
For macros saved in Alteryx One, choose whether to reference the macro or include a copy. For more details, go to Manage Cloud Macros.
Keep Sync Designer Connections selected to add or sync the workflow connections with your Alteryx One workspace.
Select Back to return to the Save dialog.
Select Save to finish.
After the save completes, select View in the success message to open the asset in the Alteryx One Library.
What You See in Manage Dependencies
Each dependency shows a checkbox, an icon, its name, and its path. Files in OneDrive and assets in the Alteryx One Library show a OneDrive or Alteryx One icon next to the location.
Dependencies are grouped by tool.
Dependencies that are available in the cloud appear under Dependencies Available in Cloud.
Dependencies that need attention appear with an alert. For more details, go to Dependency Alerts.
Save a Workflow (YXMD)
A workflow (.yxmd) does not package its dependencies. Dependencies must be available from your Alteryx One workspace. When you save a workflow as YXMD, Manage Dependencies shows alerts for files that are not available in the cloud, unsupported files, local macros, and missing dependencies. To include local files and macros in the saved asset, save as a Designer Workflow Package (.yxzp) instead.
Convert OneDrive Files to Cloud Connections (Public Preview in 2026.4)
When you save a workflow to Alteryx One, Designer checks Input Data and Output Data tools that point to local files synced from OneDrive. It converts them to connection-based files so the workflow can run and be scheduled in Alteryx One without manual rework. This applies to:
New workflows
Local workflows that you save to Alteryx One
Alteryx One workflows where you add a new local dependency
The conversion happens before you select Save. After a file is converted, the tool shows the OneDrive connection and the file path in OneDrive instead of the local path. You cannot revert a conversion manually.
What Happens When You Save
You already have a OneDrive connection: Designer switches the file to that connection automatically. If the conversion fails, Designer keeps the original local path and shows a notification.
You do not have a OneDrive connection: Manage Dependencies groups the files by driver type. Select Connect All, and then authenticate to OneDrive in the browser window.
The OneDrive connector is not installed: Designer downloads and installs it before continuing. A progress message is displayed. If the download or installation fails, an error message is displayed.
The files are not from OneDrive: Designer cannot convert them. A warning message is displayed in the Save dialog and its Dependencies section. The warning also appears in the Alteryx One asset details page, where Run and Schedule are disabled, and in the Sharing dialog. To resolve the issue, switch the file to a supported connection manually, or save the workflow as a workflow package (.yxzp).
Turn Off Automatic Conversion
To keep local paths as entered, clear Automatically Convert Cloud-synced File Paths To Connections in Options > User Settings > General. When selected, the setting uses the connection instead of a local file path for files in OneDrive synced folders, and configures Input Data and Output Data tools to use that connection automatically. The same setting also controls detection of cloud-synced files when you drag and drop files onto the canvas.
Workflow Packages (.yxzp)
Workflow packages follow the same conversion and authentication steps. Files that are already bundled in a package are kept as local files and are not converted again. When you reopen a package, its bundled files are under _externals, so Designer does not know their original location. This allows you to create fully offline packages.
Share a Workflow That Uses OneDrive Connections
When you share a workflow that uses dependencies that collaborators cannot access, the Sharing dialog asks whether to share them. Select Share all dependencies with this Workflow to share them. Workflow-specific dependencies created from a connection require each collaborator to enter their own credentials.
Dependency Alerts
Manage Dependencies identifies conditions that can prevent the workflow from running as expected.
Condition | Applies to | Details |
|---|---|---|
Missing dependency | YXZP, YXMD | The dependency displays a Missing label. Update the missing file or macro reference in the workflow, and then refresh the dependency list. Missing files aren't included in the package. |
Unchecked dependency | YXZP | The dependency isn't included in the workflow package. Select its checkbox if Workspace Execution requires the asset. Select Restore Default Selection to return to the default selection. |
File not connected to the cloud | YXMD | For a Designer workflow (.yxmd), an alert identifies files that aren't available from the workspace. Make the affected files accessible to the workspace, and then refresh the list. For OneDrive files, Designer converts them to connections automatically when it can. For more details, go to Convert OneDrive Files to Cloud Connections. |
Local file that cannot be converted | YXZP, YXMD | A warning identifies the local files that are not from OneDrive, or that Designer could not convert. The workflow cannot run in Alteryx One until you resolve the file or save as a workflow package. For more details, go to What Happens When You Save. |
Unsupported file | YXMD | The dependency displays an Unsupported label. Save as a YXZP, or update the workflow so that cloud execution doesn't rely on the unsupported file type. |
Local macro | YXMD | An alert identifies locally saved macros. Upload them to the Alteryx One Library. For more details, go to Upload Local Macros below. |
Connections aren't synchronized | YXZP, YXMD | An alert appears when you clear Sync Designer Connections. Select the checkbox to sync the connections required by Workspace Execution. |
Upload Local Macros
When a workflow uses macros that are saved locally, you can upload them to the Alteryx One Library from the Save dialog:
Select Upload All. While the upload runs, the button changes to Uploading All.
When the upload finishes, a message confirms the upload and the macros are shown as available in the cloud. The workflow references the uploaded macros instead of the local copies.
If only some macros upload, a partial upload message is displayed for the macros that did not upload.
If none upload, a Failed to upload all macros message is displayed in a dialog box. Select Retry.
Manage Cloud Macros
When a workflow package uses a macro saved in Alteryx One, the macro is selected by default and labeled Referenced Cloud Macro.
Use the three-dot menu for the macro to select one of these options:
Include as a copy: Add a local copy of the macro to the workflow package. Future updates to the original macro are not reflected in the workflow.
Referenced Cloud Macro: Restore the dependency as a reference to the macro in Alteryx One. The workflow uses the macro in Alteryx One, and future updates to the macro are reflected in the workflow. Ensure the users and Workspace Execution environments can access the macro.
Important
To run a workflow package that references a macro saved in your Alteryx One Library, your Workspace Execution engine version must be 2026.3 or newer.