Skip to main content

Save and Open Workflows

Once you have connected Designer with your Alteryx One Platform workspace, you can save your desktop workflows and Analytic Apps to the cloud and also open those saved workflows and apps in Designer from Alteryx One.

Important

Note that the navigation options can vary depending on your Designer version. The instructions below refer to the current (most recent) version of Designer.

For details, go to Workflow Management.

Save Designer Desktop Workflow or App to Alteryx One

Save your Designer assets, including workflow packages (YXZP), workflows (YXMD), macros (YXMC), and Analytic Apps (YXWZ) to your Alteryx One Library (part of your Alteryx One Workspace).

Note

Starting with the 2026.1 release, Designer saves assets to the Alteryx One Library by default.

The active workspace determines where assets are saved. You can view or change it via Manage Connections > Alteryx Links. The active workspace here matches the active workspace in the Alteryx One application.

Note

Starting with the 2026.1 release, Designer saves assets to the Alteryx One Library by default.

The active workspace determines where assets are saved. You can view or change it via Manage Connections > Alteryx Links. The active workspace here matches the active workspace in the Alteryx One application.

  1. In Designer, select File > Save As > Alteryx One (this option connects to your active Alteryx One workspace). If you haven’t configured the connection yet, follow the instructions in Create a Link between Designer Desktop and Alteryx One Platform.

  2. The current name of your workflow or app is populated by default in the Name field. You can customize the name if needed.

  3. Select the Asset Type from the dropdown:

    • Designer Workflow Package (.yxzp): (Default) Packages workflow and copies of all its dependencies.

    • Designer Workflow (.yxmd): Saves the workflow without packaging its dependencies. Dependencies must be available from your Alteryx One workspace. See Step 5.

      Note

      You can run both .yxzp and .yxmd workflows in Alteryx One using Workspace Execution, and you can add both to Schedules and Plans. .yxzp is the default asset type, and it’s the best choice when your workflow relies on local files or other dependencies that aren’t connected to the cloud.

    • Designer Analytic App (.yxwz)

    • Designer Macro (.yxmc): If you have Designer macros in your Alteryx One Library, you can insert them into a Designer workflow from the canvas in the Classic View. This capability is not yet supported in the Modern View.

      Designer references the selected macro in Alteryx One instead of relying on its local file path. This reference helps the workflow use the same macro across supported environments. For details, go to Use Alteryx One Macros in Designer Workflows.

    Workspace Execution

    Workspace Execution lets you execute Designer workflows in the cloud. Note that workflows that you build in Designer need to be edited in Designer. These workflows aren't editable in Designer Cloud at this time.

    To execute a Designer workflow in Alteryx One via Workspace Execution, you must save it to Alteryx One as a Workflow Package (.yxzp).

  4. The Location field indicates that the asset will be saved to the Alteryx One Library. If needed, select the folder where you want to save your asset. The folder name is included in the path in the Location field (for example, Alteryx One Library/myfolder. To create a folder, select New Folder, enter a name, and press Enter.

  5. If you select a Designer package that includes dependencies, use the Dependencies section to review them. Select Manage to open Manage Dependencies where you choose which dependencies to include. Unpackaged assets don't contain dependencies. For more details, go to Manage Dependencies for Workspace Execution.

    For Workspace Execution, make sure all dependencies and connections are accessible from your Alteryx One Workspace.

    • In Manage Dependencies, dependencies are grouped by tool, in the order the tools appear on the canvas. All dependencies are listed, including local and Alteryx One macros, datasets, and data dependencies that use local file paths or DCM connections.

    • Uncheck an asset to omit it from the workflow package. Select Restore Default Selection to return the checkboxes to their initial state.

    When you save a workflow to Alteryx One, you can upload macros referenced by a file path and manage existing Alteryx One macro references.

    • For macros referenced by an absolute or relative file path, select Upload All to upload them to your Alteryx One Library. The workflow then references the uploaded Alteryx One macros instead of their file paths. If an upload fails, select Retry.

    • Alteryx One macros are selected by default, and the package retains their Alteryx One references. Each macro is labeled Referenced Cloud Macro in Manage Dependencies, with a location such as Alteryx One Library/MyMacro.

    • To package an Alteryx One macro with your workflow, select the Include as a copy from the macro’s three-dot menu. This includes an independent copy* of the macro in the package (labeled Macro Copy in the dependencies list.)

    • Make sure users and Workspace Execution environments can access any macro that remains referenced from Alteryx One.

    Important

    *If you select an Alteryx One macro in Dependencies, the workflow uses a copy of the macro included in the package. Future updates to the original cloud macro won’t be reflected in your workflow. To use the original cloud macro, uncheck the box and exclude it from the package.

    When a workflow includes a referenced macro and you save it to Server, the macro is always included as a copy. Future updates to the original cloud macro won’t be reflected in the workflow.

    • Local Macros: If your workflow references macros by an absolute or relative file path, an alert is displayed. Select Upload All to upload them to your Alteryx One Library. The workflow then references the uploaded macros. If an upload fails, select Retry.

    • OneDrive files: Before you save, Designer converts Input Data and Output Data tools that point to OneDrive synced local files to cloud connections, so the workflow can run in Alteryx One. Go to Manage Dependencies for Workspace Execution.

    • Cloud-ready flat files: Input Data and Output Data tools that use flat files on a local path aren’t cloud-ready. If you save the workflow as a workflow package (.yxzp), Designer includes these files as dependencies, so no cloud connection is needed. If you save it as a workflow (.yxmd), the dependencies aren’t included, so connect the files to the cloud through Data Connection Manager (DCM) first. Manage Dependencies lists these files under Input Data or Output Data. Designer also detects files in a OneDrive-synced folder when you drag them onto the canvas or select them, and again when you save the workflow in the Save dialog. It then converts the tools to cloud connections automatically (OneDrive only).

    • Alerts: Manage Dependencies alerts you to missing dependencies, files not connected to the cloud, unsupported file types, unchecked dependencies, and local macros. Resolve them before you save, or save as a workflow package (.yxzp).

  6. The Sync Designer Connections checkbox is checked by default to add or sync all connections that are used in the workflow to your Alteryx One workspace. This sync is needed to execute the workflow successfully (and avoid errors) via Workspace Execution. If you clear it, an alert appears.

    Important

    This option is available in Designer version 2025.1 and newer.

  7. Select Save*. At this time, Alteryx validates your workflow or app to confirm that it doesn’t use prohibited non-DCM data connections. Review Tool, Engine, Driver, and Connector Compatibility for details. Once the save is successful, a success message appears. Here, you can select View (this opens the Alteryx One library where the workflow was saved) or select x to continue working in Designer Desktop.

    *If you’re already authenticated to your Alteryx One workspace, you’re all set. If you’re not authenticated, the save triggers your default browser to open a new window where you can sign in to the Alteryx One workspace that you are saving to.

View Designer Desktop Assets in Alteryx One

Tip

Note that different options are available for standard workflows and Analytic Apps. For example, you can schedule a workflow run but not an app.

Once saved to Alteryx One, you can find your Designer workflows, macros, and Analytic Apps in the Alteryx One Library. You can use the filter (funnel) icon, select Asset Type, and choose Designer > Workflow Package, Workflow, Macro, or Analytic App.

In the Library, you can perform several actions (depending on your user permissions), including...

  • Schedule or run your workflow (.ymxd) in Alteryx One, run your Analytic App directly in Alteryx One

  • Download a file that contains the workflow or app and any packaged assets.

  • Delete your Designer workflows and apps from Alteryx One.

  • Apply labels, share assets with other users, and create folders to organize assets.

Use the three-dot menu associated with the workflow or app to access these options. For more information, go to the Library for Assets.Library

Unresolved local dependencies: If a saved workflow still depends on local files that aren’t available in the cloud, a warning appears on the asset details page and Run and Schedule are disabled until you resolve the dependency in Designer or save the workflow as a workflow package (.yxzp). A similar warning appears in the Sharing dialog.

Open Designer Asset from Alteryx One

Follow these steps to open a Designer asset from the Alteryx One library. The asset opens in Designer.

  1. In Designer, select File > Open Workflow > Alteryx One. The Open from Alteryx One workspace dialog appears (this option connects to your active Alteryx One workspace). Here you can access your Alteryx One Library. If you haven’t configured the connection yet, follow the instructions in Create a Link between Designer Desktop and Alteryx One Platform.

    You can also access desktop workflows saved to Alteryx One via File > Open Recent.

  2. If you want to open a local file, select Open From Local at the bottom of the modal. Otherwise, you can select the Designer asset that you want to open from the Library.

    The Library displays these asset details:

    • Name: The name of the asset.

    • Asset Type: Lists the Designer asset type: Workflow, Macro, Analytic App, or Workflow Package.

    • Shared With: Lists the users with whom the asset has been shared.

    • Owner: The owner of the asset.

    • Last Updated: The timestamp of the last update.

    There are a number of filtering and search options available to help you find your asset:

    • Use the All, Owned by Me, and Shared With Me options to narrow your list of assets as needed.

    • Use the funnel icon to apply a filter to the library.

    • Use the Search field to find your asset by Name.

  3. Once you locate the asset that you want to open, select it from the list. The asset opens in Designer.

Download Designer Asset from Alteryx One

Alternatively, you can download your Designer workflow, macro, or app directly from the Alteryx One library. To do so…

  1. In Alteryx One, go to Library and use the funnel icon to filter by Asset Type. Select Designer to view Designer assets.

  2. Locate your Designer workflow, marcro, or Analytic App and use the three-dot menu to select Download.

The download creates a YXZP file that includes the asset and any packaged assets.

Next Steps

After you save your Designer workflows and apps to your Alteryx One workspace, you're ready to run or schedule them. Go to View and Execute with Workspace Execution to learn how.