Workflow Management
Decoupled Designer and Server Updates
To modernize the update experience and reduce IT overhead, Alteryx has decoupled Designer and Server updates. This change allows you to upgrade Designer independently from Server, so users can immediately access the latest Designer features without waiting for Server approval or environment upgrades. This improvement streamlines adoption, accelerates access to new functionality, and reduces delays—especially for organizations with lengthy Server update cycles.
With this enhancement, assets built in newer versions of Designer are no longer blocked from being published to older Server environments. Instead of a blocking error, users will now see a warning and can choose whether to proceed, empowering teams with more flexibility while reducing workflow disruptions.
For important details, limitations, and ongoing updates, go to Designer Server Version Compatibility.
As part of workflow management, you can save the workflows you build in Designer so that you can reuse them or share them with other users in your company's Server.
You can also manage existing workflows in your company's Server by opening them in Designer. From Designer, you can edit, save, and share these workflows back to Server. Server maintains previous versions of a workflow, so when you save the revised workflow to your company's Server, it doesn't replace the previous version.
If you want to save and share a workflow along with its dependencies, like files and connections, you can export them together as a YXZP file. Like single-file workflows, you can share exported workflows with others in Server, and open them in Designer.
In addition to saving single workflows, you can save multiple workflows as a workflow group that you can then open as 1 workflow group file (.yxwg). You can only create workflow groups of existing, locally saved workflows.
Workspace Execution
With the Alteryx One platform, you can save your Designer-built workflows to the Alteryx One library. You can then run or schedule workflows in the cloud. Go to Workspace Execution to learn more.
Save Workflows
With the workflow open, select File > Save As, then select the location where you want to save the workflow.
In 26.1, you can now save workflows in multiple formats i.e, Workflow (.yxmd), Macro (.yxmc), Analytic App (.yxwz)
File Directory (Browse)
To save your workflow to your local file directory, follow these steps:
Select Browse.
In File Explorer, go to the location where you want to save the workflow.
In File name, enter a name for the workflow.
Select Save.
Alteryx One
Save your Designer assets (workflows, macros, and Analytic Apps) to your Alteryx One Library (part of your Alteryx One Workspace).
To save your Designer assets to your Alteryx One library, follow these steps:
Select File > Save As > Alteryx One (this option connects to your active Alteryx One workspace).
Important
If you open an asset from one workspace and then switch to a different active workspace, saving the asset results in an error.
Enter a Name for your asset.
Select the folder where you want to save your asset.
Select the Asset Type: Workflow Package
Once you select Workflow Package, use the Dependencies section to review dependencies and determine how you want to group them. Unpackaged assets don't contain dependencies.
For Workspace Execution, make sure all dependencies and connections are accessible from your Alteryx Cloud.
Turn on the Group By Tool* toggle to show all of the workflow's assets or file dependencies grouped together with the tool they are connected to. This setting organizes assets for each tool so that information is easier to parse—it doesn't change how the YXZP file is created.
Uncheck an asset to omit it from the workflow package.
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.
Note
In 26.1, Designer saves assets to Alteryx Cloud 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.
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.
Alteryx Server
Decoupled Designer and Server Updates
With the 2025.2 release, assets built in newer versions of Designer are no longer blocked from being published to older Server environments. Instead of a blocking error, you will now encounter a warning message and can choose whether to proceed.
For important details, limitations, and ongoing updates, go to Designer Server Version Compatibility.
By default, Designer saves the workflows you own to your private workspace. Workflows shared with you in a collection are saved to the collection.
Select Save As.
Select Alteryx Server > My Company's Server.
Sign in with your username and password. Select Keep me logged in to keep your session active, as desired.
In the Save Workflow window, enter a Workflow Name. By default, Location displays the studio where the workflow will be saved. If the workflow has been shared with you in a collection, Location displays the collection.
In Worker Tag, select an option to assign a specific worker to run the workflow.
(Optional) In Details, enter any helpful comments.
(Optional) Select Workflow Options to select one of these:
Workflow Option
Description
Publish this version of the workflow
Publish this version of the workflow as the available version in Server.
This option is only available if the workflow has been saved to the Server before. Do not select this option if you do not want other users to use this version of the workflow.
To update the workflow version in the Server...
View app details and select Version # to view available versions.
Select a version and select Make Published Version.
Validate workflow then save
(Default option) This option is selected by default. Validation checks if there are prohibited tools or commands. If validation fails, the workflow requires an exemption to run in your company's Server. Contact your Server admin to request that they change the run mode for your workflow.
These tools require exemptions to be run in the Alteryx public gallery: R tool, Run Command tool, Python tool, Email tool, and Download tool.
Server doesn't allow event or chained app execution. Go to Workflow Configuration and Interface Designer Window.
Go to Save to Server Messages for additional information about applying for an exemption.
AMP Engine
If your workflow is using the AMP engine, but your controller is not, workflow validation is disabled and cannot be enabled. To enable workflow validation, enable the AMP engine on the controller or change your workflow to run on the original Alteryx Engine via Workflow Configuration.
To learn more about the AMP engine, refer to these resources:
Manage workflow assets
View and manage the assets associated with the workflow.
Select Group assets by tool* to display all of the workflow's assets or file dependencies that are grouped together with the tool they are connected to.
Deselect an asset to omit it from the workflow package.
Assets that include a constant in the input path display in the list of assets but are not included in the workflow package.
*This setting organizes the assets for each tool so that information is easier to parse—it does not change how the YXZP file is created.
Enable workflow locking
View locking options for the workflow.
Select Restrict use to specific serial numbers to limit the use of the locked workflow to only the specified serial numbers. When selected, only the serial numbers (email addresses) in the list can use the locked workflow. To enable a workflow to run on the Server, you have to list the serial number for the Server, which is the default Server Administrator. The default Server Administrator is set up when setting up the Server authentication. Go to Configure Server Authentication for more information. Enter each unique serial number (email address) 1 per line.
Select Set expiration for locked workflow to set the locked workflow to expire on the selected date. When the expiration date is reached, the workflow can't be run or used.
Check the box to indicate that you acknowledge the implications of locking your workflow.
Select Done to lock your workflow.
Go to Lock Your Workflow for more information.
Set workflow credentials
In order for this option to be available, a Curator (Server Admin) must select the Allow User to Select setting via Admin > Settings > Configuration > Assets > Workflow Credentials Settings.
Once enabled, users can select the credentials for running the workflow:
User is not required to specify credentials: Run the workflow using the default server or studio credentials.
User must specify their own credentials: Prompt a user to enter their own credentials to run the workflow.
Always run this workflow with these credentials: Enter credentials to always use when the workflow is run.
Select Save. Go to Save to Server Messages for more information about errors and warnings you might receive when you try to save a workflow to a Server.
Alteryx Server: Add New Server
Decoupled Designer and Server Updates
With the 2025.2 release, assets built in newer versions of Designer are no longer blocked from being published to older Server environments. Instead of a blocking error, you will now encounter a warning message and can choose whether to proceed.
For important details, limitations, and ongoing updates, go to Designer Server Version Compatibility.
Select Save As > Alteryx Server> Add New Server.
On the Save Workflow - Add a Server screen, use the URL field to enter the URL path to your company's Server.
Select Connect.
Based on the Server configuration, authentication steps vary:
Configuration Type
Authentication Steps
Built-in Authentication
In Email and Password, enter your Server email and password.
Select Keep me logged in, if desired.
Select Connect.
Windows Authentication
A user name displays.
Select Continue to sign in.
Select the Server from the list, then follow the steps to save the workflow to your company's Server.
Template
Save your workflow, macro, or analytic app as a template to use as a starting point for future projects. Go to Templates for details.
Save a New Template
You can save an existing workflow, macro, or app as a template. Follow these steps to do so:
With a workflow, macro, or app open in Designer, select File > Save As.
Select Template to open the Save As Template dialog.
Use the Save as Template dialog to provide some template metadata. The metadata becomes part of the template's XML and you can edit it at a later time if you need to.
Owner: Enter the name of the template owner. This can help template users find the right person should they have questions about the template.
Name: Enter a name for your template. Note that Designer uses your project name by default and preconfigures the file type based on the project that you started with (workflow, macro, app). Refer to Template File Types for more information.
Description: Enter a description for the template, for example, its intended use case. This helps template users determine whether this template is appropriate for their project.
Image: Upload an icon or screenshot of the key part of your workflow, macro, or app. Accepts JPEG and PNG file formats.
Select Save to save your template or Close to go back to your project.
Designer saves your template to the Template folder at this location (unless you specify a different location via the Change Workflow Template Directory steps):
C:\Users\[USER]\AppData\Local\Alteryx\Templates
You can access, edit, and use your template from Designer's main menu via File > Templates.
Export Workflow
Export a workflow and its dependencies as a YXZP package file. You must save the workflow before you can export it.
Dependency File Packaging
These assets are automatically included with an exported workflow:
Input Files
Output References
Macros
Chained Apps
User-added Files
These files are not included with an exported workflow:
Missing Files
Files Identified as Being Part of the Alteryx Installation
Files Referenced by a Network Path
Input Paths that Contain a Constant
When you export a workflow and its dependencies, Designer maintains the original file format of each file. The folder structure of the assets included in the workflow is maintained as long as the files included are children of, or siblings to, the workflow file. All other files are considered external, and, if included with the package, will be placed in an _externals folder.
Use workflow dependencies, to ensure that no paths are broken when referencing missing files.
Export Workflow
Select Options > Export Workflow to display the Export Workflow window. Workflow displays the name of the workflow and its file extension.
Complete any of the available configuration options:
Option
Description
Lock
You can't undo locking. Alteryx recommends that you configure this setting last.
Create a copy of the workflow, app, or macro that can be run but not opened and edited in Designer.
Select the Lock button.
Select Enable locking for this workflow.
Configure these options, as appropriate:
Restrict use to specific serial numbers (one per line): Enter the serial numbers of the licenses you want to be able to access the locked workflow. List each serial number on a separate line. A serial number is used for each Alteryx install. To view your serial number...
Go to Options > Manage Licenses and select the gear icon in the upper right.
Next, select View Partner Data License Manager and see your Machine Serial Number in the upper-right portion of the window.
Set expiration for locked workflow: Set the locked workflow to expire on the selected date. When the expiration date is reached, the workflow cannot be run or used.
Check the box to indicate that you acknowledge the implications of locking your workflow.
Select Done to lock your workflow.
Package Location
Change the location where the file is saved.
Group Assets by Tool
Group the assets in the workflow by the tools in which they are used. If this option is not selected, assets are listed individually.
Deselect an asset to exclude it from the workflow package. The asset is referenced, but it is not included in the package.
Assets that include a constant as part of an input path will display in the list of assets, but they are not packaged as part of the workflow.
Select Save. Go to Lock Your Workflow for more information.
Save Workflow Groups
Additional Considerations
You can only create a workflow group of existing, locally saved workflows. If you try to create a workflow group from workflows saved in Alteryx Server, you must first save each workflow individually on your local drive.
If you move or delete a workflow that is part of the workflow group, Designer displays an error when you try to open the workflow group.
Open all locally saved workflows to include in the group. The Start Here.yxmd is not saved with a workflow group.
Select File > Create Workflow Group.
In File Explorer, go to the location where you want to save the workflow group.
In File name, enter a name for the workflow.
Select Save to save the individual workflows into a single workflow group file (YXWG).
Open Saved or Exported Workflow
Open workflows from a file directory or your Server.
Open Single Workflow from File Directory (Browse)
Select File > Open Workflow > Browse.
Go to the location where you've saved the workflow.
Double-click the file name to open it in Designer.
Exported Workflows
If the workflow is in an exported YXZP file, do this:
In the Package Import message, select Yes to import the workflow.
On the Import Workflow Package window, verify this information:
Package File Name: Display the complete path to the file.
Workflow: Display the workflow name. The assets in the package display in the box.
Destination Directory: Display the location where you want to save the package. To change the location, select the floppy-disk icon, then select a new location.
Select Import.
In the Workflow Import Progress window select Yes to load the workflow. If the workflow fails to load properly, try to import it again.
Open Workflow Group from File Directory
Select File > Open Workflow Group.
Go to the location where the workflow group file has been saved.
Double-click the YXWG file to open. Each workflow within the group opens on a separate tab in Designer.
Open Asset from Alteryx One
Follow these steps to open a Designer asset from your Alteryx One Library (part of your Alteryx One Workspace). The asset opens 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 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.
Once you locate the asset that you want to open, select it from the list. The asset opens in Designer.
Open Workflow from Server
Select File > Open Workflow > My Company's Server.
Sign in with your username and password. Select Keep me logged in to keep your session active, as desired.
In the My Company's Server window, locate the workflow. You can use Search, use the All Locations dropdown to filter, and select column headers to sort the results.
Select the Versions icon to the right of a workflow to view previous versions, as needed. This option must be enabled in Server to be visible in Designer.
Select the workflow and select Open. Go to Save to Server Messages, for more on errors and warnings you might receive when trying to save a workflow to a Server.
Add New Server
Select File > Open Workflow > Add New Server.
In URL, enter the URL path to your company's Server.
Select Connect.
Based on the Server configuration, authentication steps vary:
Configuration Type
Authentication Steps
Built-in Authentication
In Email and Password, enter your Server email and password.
Select Keep me logged in if desired.
Select Connect.
Windows Authentication
A user name displays.
Select Continue to sign in.
Select the Server in the list and follow the steps to open a workflow saved to your company's Server.