Link Designer Desktop and Alteryx Analytics Cloud
Before you can use Cloud Execution for Desktop, you need to create a link between Designer Desktop and your Alteryx Analytics Cloud (AAC) workspace.
Once you successfully connect Designer Desktop to the Alteryx Analytics Cloud platform, the connection details are available via File > Manage Connections > Alteryx Links. Select the Data Source Name in the Name column to view the connection details, edit the connection, or delete the connection.
To connect Designer Desktop with AAC...
The process of connecting to AAC is simplified via the Cloud Link Wizard for Designer Desktop versions 2025.1 and newer.
In Designer Desktop, go to File > Manage Connections to open Data Connection Manager (DCM).
Select Alteryx Links in the left-hand menu and select the + New button to open the Cloud Link Wizard.
Select the cloud instance where you want to connect (United States, Europe, Australia, Custom Instance) and select Launch to proceed. Your instance is the region that you use to sign in to your Alteryx Analytics Cloud account. You can find this in the URL of the workspace that you want to connect to.
Alteryx launches your browser window, where you can enter your email address to sign in to your AAC account.
Next, choose the workspace that you want to connect to.
If your connection is successful, you'll receive a success message in the browser and in Designer Desktop. You can close these and proceed to use Cloud Execution for Desktop.
In Designer Desktop, go to File > Manage Connections to open Data Connection Manager (DCM).
Select Alteryx Links in the left-hand menu and select the + New button.
Analytics Cloud is preselected as the default Technology. Provide the required information:
Data Source Name: This is the display name (label) for this link. The name is displayed in the Save As and Open menus and helps users identify this connection.
Cloud Instance URL: This is the URL that you use to access the Alteryx Analytics Cloud platform (for example, https://region.alteryxcloud.com/). Contact your AAC Admin for this information.
Workspace Name: This is the name of your AAC Workspace, as it appears in the URL (after the Base URL). For example, you might access AAC via
https://region.alteryxcloud.com/?workspace=my-workspace. In this case, you would entermy-workspacein the Workspace Name field. Contact your AAC Admin for this information.
Select Save. Next, you need to link credentials.
Select + Connect Credential to get started.
Cloud Execution for Desktop supports the OpenID Connect (OIDC) authentication method. This option is preselected in the Authentication Method dropdown.
In the OIDC TOKENS section, use the Credential dropdown to choose an existing credential or select Create New Credential.
If you need to create a new credential, enter a Credential Name. This label should help you identify it in the future.
The Vault is set to DCM by default.
You can also select Test Connection or Create and Link to finish. If you’re not already signed in to your AAC workspace, your browser will ask you to authenticate to AAC.
重要
If your connection fails, ensure that the Base URL and Workspace Name for your AAC connection are correct.
View, Edit, and Synchronize Alteryx Links
Once you’ve created a link between Designer Desktop and AAC, you can seamlessly connect and synchronize your Designer Desktop with AAC for Cloud Execution on Desktop. This allows you to keep your connection information consistent across both platforms.
Your credentials are available to sync via the Connections section of each link created via Alteryx Links:
Go to File > Manage Connections > Alteryx Links.
Select the Name of the existing link to open and view the details.
To update the link, select the Edit button. Make the necessary edits and select Save or select Cancel to return to the previous screen.
In the Connections section, you select Synchronize to sync your credentials between Designer Desktop and AAC.
Once the sync is complete, a confirmation appears. If there is an issue with the sync, an error message appears.
Next Steps
Now that you have connected Designer Desktop to your Alteryx Analytics Cloud workspace, you can save your desktop-built workflows to AAC and open them in Designer Desktop from the cloud. Go to Save and Open Workflows to learn how.