Alteryx Designer Knowledge Base

Definitive answers from Designer experts.

The Ultimate Input Data Flowchart

Alteryx Alumni (Retired)

"I have a bajillion files that I need to bring into my workflow... wayyyyyy too many for me to use individual Input Data tools! What's the best way to do this?"

- every Alteryx user ever


Bringing in multiple files at once can sometimes seem like a daunting task, but is often a necessary piece in developing those wonderful time-saving workflows. Here's a handy flowchart to help you get those tricky files in without a hitch!




1. Input Data with wildcard


Most of the time you just need an Input Data tool to get your data in, which is great, because it's by far the easiest and fastest method here.





  • You need all of your files to be in the same directory.
  • All files must be the same type (e.g. csv, xlsx, yxdb)
  • All files must have the same schema.  (The same field names must be in the same order and have the same data types.)

How to do it:

  1. Configure an Input Data tool to bring in one of the files in your directory.
  2. In the connection string, replace the filename (or a portion of the filename) with an asterisk (*). The asterisk is a wildcard that essentially takes the place of anything.


So in our flowchart above, this connection string will look in the directory C:\Users\akoszycki\Desktop\Input Data\Data to Input and then pick up every file that starts with "CO Store File - " and ends with ".xlsx".



  • All of the data from these files is stacked on top of each other.
  • If you want to see which file the data comes from, use the "Output File Name as Field" option in your Input Data tool configuration.

file name.PNG




2. Dynamic Input with file paths


Sometimes the universe conspires against you and you can't use a wildcard. Why? Well maybe it's impossible to have all of your files located in the same directory, or maybe there are a ton of files in the directory that you don't want a wildcard to pick up. In this case you'll need to use a list of filepaths to feed a Dynamic Input.



  • All files must have the same schema.  (The same field names must be in the same order and have the same data types.)
  • A list of filepaths to import. fullpths.PNG
  • A file to populate the "Input Data Source Template" configuration of the Dynamic Input tool. This file will always have to be available for the tool to base its field schema on, and can be any of the files you wish to input. It *will not* be input if it is missing from the aforementioned file list.

How to do it:

  1. Configure the Input Data Source Template in the Dynamic Input just as if it were a regular Input Data tool.
  2. This tool includes an option to "Read a List of Data Sources" that will update the connection string based on your list of filenames.



Working with tables:

Some file types require a table or sheet specification, such as Microsoft Excel or Access database files. If the sheet or table name is always going to be the same, you won't have a problem with the Dynamic Input tool. However, if your files have different tables or sheets that you're pulling from, you may get an error like...

sheetname error.PNG

 If this happens, you'll have to add the table/sheet to the end of the file path in the form ‹file path›|||‹sheet/table›. For example, in the flowchart above I'm specifying "Sheet1" as the worksheet to import from the Excel files by using a simple formula:[FullPath]+"|||Sheet1$".


3. Batch Macro with file paths

No matter what you do, it seems you always get these pesky messages that keep your files from coming in. This is when we bring out the big guns - Batch Macros. Though this last method is the most work-intensive initially, let's remember to keep in mind what my good buddy Confucius always says...



The batch macro will run a workflow one time for each file, updating the Input Data tool each time. It would generally look like this:




The Batch Macro will automatically read in files which have the same field schema without errors. But what happens if your field schema is different from one file to another?


This is where the batch macro really comes into its own! Navigate to the Interface Designer (View > Interface Designer) output mode idea filter, and either use ‘Auto Configure by Name (Wait until All iterations Run)’ or ‘Auto Configure by Position (Wait Until All Iterations Run)’. 'Auto Configure by Name' will union the fields with the same names, and 'Auto Configure by Position' will union field 1 from file 1 on top of field 1 from file 2 and so on for every file.




Once you have configured the Interface Designer you can save the macro and insert it into your workflow (Right click on the canvas Insert > Macro...). There is an example workflow attached which includes dummy files and the Batch Macro to see how the process works.


That should do it for inputting your data! Comment below or reach out to Customer Support with any questions!

No ratings

That you didn't understand the question implies that you are not taking that important step.  Follow the link in my post above to learn more, but in a nutshell, use Options > Export Workflow then make sure the macro is checked.  Specify the location you want to save to, and click Save.  Then send your colleague the .yxzp.  The macro (ending with .yxmc) will be packaged with the rest of the workflow, and when your colleague gets it, opening the package will prompt import of the workflow.Export WorkflowExport Workflow

11 - Bolide

Thank you @LisaL . Very clear. Appreciate your time.



6 - Meteoroid

Hello community.


I am having trouble getting  Batch Input to work.  the output is multiple instances of the first file.


I am trying to input 31 files.  The first file has 30 records. After running the macro. I am getting 930 records all from the first file. 


It appears that the batch macro is not updating with the information from the other 30 files. 


Does anyone has experience with using the Batch Input Macro from this post.  




6 - Meteoroid

Hello community,


Does anyone have a batch macro that can input multiple macro enabled Excel files (.xlsm) from one 1 folder?  


thanks in advance.


7 - Meteor

This is fantastic, but what if the Excel files contain multiple worksheets? Didn't seem to find a clear answer in the above responses.


That is a good question.  If you are looking for the same sheet name in every file, you can address that pretty easily with a Formula tool as shown in the original article's orange section.  If they are different sheet names in every file, then you'll need to use some conditional logic in the Formula tool to make sure that the |||SheetName$ gets appended to the correct path and filename.

Instead of using the .xlsx suffix, make it .xlsm.  You'll want to make that change in the Input Data tool within the macro as well as any Directory tool you use.

If you have the same file opening multiple times, check the following:

  1. Do you have more than one record with the same file (path and file name) in the field that you use to feed to the macro? 
  2. Check that the Action tool is updating the wrong part of the Path/FileName. 
  3. One thing with the Action tool that is not obvious is that it will update whatever information is in blue. 
  4. Another Action tool oddity is that if you are replacing the entire value, do not check the Replace a specific string box at all.

7 - Meteor

Thanks @LisaL. I think the formula option will work, but I only see a screenshot in the original post, so I'm not able to see what that formula is. Do you know what it is?


How you configure the workflow will totally depend on your use case.  The Virtual Solution Center has an option for "I need help building something."

5 - Atom

SUPER practical and TO THE POINT!


Thank you for this article!

6 - Meteoroid

Thanks for sharing this; I'm sure it will come in handy!

6 - Meteoroid

Hi y'all, 


I am trying to import data from three multiple macro enabled Excel files. My settings are on par with the first use case (the files are into the same directory, and the structure - column's names and position - is the same across all of them). 

But I am facing an issue when using wildcard to bring in data from my files at once. It outputs only data from the first file.

Below are my Workflow, the Input tool configuration and the files name. 

 Need help please. Thank you in advance. 


Settings.png2022-03-29 00_02_34-Matrices.pngWF_Multiple_Input.png

5 - Atom

This was explained so well, thank you!

5 - Atom


7 - Meteor

This is very helpful. Thank you for your help.

5 - Atom



Can anyone help me explaining how to implement the second flow chart
Importing the files from multiple directory