ALTERYX INSPIRE | Join us this May for for a multi-day virtual analytics + data science experience like no other! Register Now
2 Day Countdown - The Alteryx Community will be temporarily unavailable for a few hours due to scheduled maintenance starting on Thursday, April 22nd at 5pm MDT. Please plan accordingly.

Alteryx Designer Knowledge Base

Definitive answers from Designer experts.

How to ensure Macros are inserted with Relative paths


How to Ensure Macros are inserted with Relative Paths

Designer will reference the macro location (macro path) differently depending on the way in which the macro is inserted onto the Canvas. This can be important when you have a mapped drive that references macros, and especially when you want to promote workflows to different environments (Dev > Production) without needing to manually change the workflow.

The macro will insert itself as relative in these cases:

  1. Drag and drop from the Tool Palette.


  1. Right-click > Insert > select the name of the folder (same as in Tool Palette) > select the Macro
  1. Right-click > Insert > Macro > Browse... > navigate to the path (referenced as a UNC/Network path) and select the Macro file

These are the conditions in which it will NOT insert the path as relative, and therefore will fail in the higher environment:

  1. Right-click > Insert > Macro > click the Macro directly (this option is only available when the macro was recently saved, as it only displays the most recently modified macro)
  1. Right-click > Insert > Macro > Browse... > select the macro from a mapped drive (C:\users\etc)