Use Alteryx One Macros in Designer Workflows
Insert Alteryx One macros, which are macros saved in your Alteryx One Library into Designer workflows. 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.
Before You Start
Make sure you’re online and Designer can access the internet.
Sign in to the Alteryx One workspace that contains the macro.
Confirm that you have access to the macro.
Your active workspace determines which Alteryx One Library Designer uses.
Insert a Macro from Alteryx One
Important
To insert an Alteryx One macro into a workflow, Designer must be in Classic View. This option is not yet available in Modern View.
If you have Designer macros in your Alteryx One Library, you can insert them into a Designer workflow from the canvas.
In Designer, right-click an empty area of the workflow canvas.
Select Insert > Macro > Browse in Alteryx One. Any Alteryx One macros already open in Designer are identified by a cloud icon.
In the macro browser, locate and select a macro. You can use the available filter options to narrow the list:
Select from All, Owned by Me, and Shared with Me.
Use the filter (funnel) icon to show macros based on these categories:
Owner: Show macros created by specific users.
Shared With: Show macros shared with specific users.
Tag: Show macros with specific tags applied.
Created By: Show macros created by specific users.
Use the dropdown in the Version column to select the version to use:
Select a numbered version to keep the workflow linked to that version.
(Default) Select Always Use Latest Version to always use the latest available version. At runtime, the workflow uses the latest version available in the Alteryx One library. The version is selected when workflow execution first reaches the macro and remains fixed for the rest of that workflow execution. This option does not limit selection to published versions.
Select Insert.
Designer adds the macro to the canvas and stores its Alteryx One asset reference and version selection in the workflow.
A cloud icon indicates open macros in Designer that were opened from Alteryx One. You can also insert one of these open macros from Insert > Macro.
Important
Alteryx One macros are currently not available in the Designer tool palette. To use Alteryx One macros in Designer, add them to your workflow with the right-click Insert option.
Change Macro Version
Right-click the macro on the canvas.
Select Choose Macro Version.
Select a numbered version or Always Use Latest Version (if you always want to use the latest available version).
If you select Always Use Latest Version, the workflow can use a newer macro version when one becomes available. Review the workflow after the macro owner publishes an update.
Open a Referenced Macro
Double-click an Alteryx One macro on the canvas to open it in a new Designer tab. You can also right-click the macro and select Open Macro.
Designer retrieves the selected macro version from Alteryx One. If Designer is offline, it can open the macro only when that version remains available in the local cache.
Work Offline
When Designer is offline, only Insert > Macro > Browse Local is available and opens the local file browser. You can insert a local YXMC file, but you can’t browse the Alteryx One Library.
An Alteryx One macro already in the workflow might remain available from the local cache. Designer displays an error if it can’t retrieve the referenced macro.
Save or Package the Workflow
Workspace Execution
To run a Designer Workflow Package (YXZP) that references a macro saved in your Alteryx One Library, your Workspace Execution engine version must be 2026.3 or newer.
Designer preserves Alteryx One macro references when you save the workflow as a YXZP file to Alteryx One.
When you save a workflow package as a YXZP file in Designer via File > Save As > Alteryx One:
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 its location shown as
Alteryx One Library\MyMacro, for example.To package Alteryx One macro with your workflow, select Include as a copy from the macro's three-dot menu. This includes an independent copy* of the Alteryx One macro in the package (indicated by "Macro Copy" in the Dependencies list).
Make sure users and workspace execution environments can access any macro that remains referenced from Alteryx One.
To restore the reference to the macro in Alteryx One, select Referenced Cloud Macro from the three-dot menu.
Macro Copy
*If you select Include as a copy, the workflow uses the copy of the macro included in the package. Future updates to the original Alteryx One macro won't be reflected in your workflow. To use the original macro again, select Referenced Cloud Macro from the three-dot menu.
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 Alteryx One macro won’t be reflected in the workflow.
Local macros: If your workflow also uses macros saved on your computer, an alert appears in Manage Dependencies. Select Upload All to upload them to your Alteryx One Library. From that point, the workflow references the Alteryx One macros instead of the local file paths. If an upload fails, select Retry. Go to Manage Dependencies for Workspace Execution.
You can include a Designer macro as a dependency in a workflow package (.yxzp), but you can't save a package with a Designer macro as it primary asset. Designer displays an error message if you try.
Go to Workflow Management for information about saving workflows and managing package dependencies.