MyAlteryx
Community
Academy
Help Docs

Welcome to the Alteryx Knowledge Base

Knowledge Base / Designer / Unhandled Exception Occurred, Now What?
Unhandled Exception Occurred, Now What?
user

Created/Edited - 6/17/2026 by Lisa LePome | Alteryx

Summary
Where do you start when you see "An Unhandled Exception occurred"?
Description

This error message is non-specific and caused by an issue beyond what the programmers expected. This will require a deeper investigation of various logs, as the error can be caused by a range of issues.

Issue
An Unhandled Exception occurred.

A previous action may not have completed successfully.

Click OK to send the development team the error log so that we can fix this error in a subsequent release.


Environment
  • Alteryx Designer or Alteryx Server
    • All versions
Resolution

Next Steps for Troubleshooting:


Gather comprehensive logging to share with Alteryx Support for investigation using either a Support File (A) or manually gathering logs (B):

 
A) Generate a Support File ZIP:
 

  • For 2021.3+, logs can be collected by generating a Support File. Please ensure that Engine Logs have been enabled and recorded for the workflow that may have led to this Unhandled Exception error:
    • In Designer, go to Help > Generate Support File

 

B) Manually gather logs for review:

  1. Pay close attention to what you were doing when the error occurred.  Were you modifying a tool's configuration or issuing some sort of command like opening, running, or saving something?
  2. Look for Error Logs that might have been generated for the error.
    1.  If Error Logs have been created, they'll be in %ProgramData%\Alteryx\ErrorLogs.  ProgramData is a hidden directory, so you may need to paste that path into your File Explorer or set it to show Hidden Items:


      image.png
       
    2. If the ErrorLogs directory exists, open it and look for appropriate time stamps, including within subdirectories.
    3. If there is a log with an appropriate timestamp, particularly in the AlteryxGui subdirectory, open it in an editor like Notepad or Notepad++ and see what it says beside "Message:".  There are some examples below:

      image.png
       
      image.png
       
      image.png
       
      image.png


    4. If there are no relevant logs in the Alteryx\ErrorLogs directory, then you should pull the Windows Event logs.
    5. If you can identify the problem, go ahead and fix it.  Even if you cannot interpret the messages in the logs, at least you can search the Community with more information than just "Unhandled Exception." OR see the articles attached in the Additional information.
    6. If you cannot find relevant information in the Community, then please open a case by contacting Customer Support and describe what you were doing when you saw the Unhandled Exception, preferably with a full screen shot that includes context.  Also, provide the error logs you found.

 

Known Causes and Resolution Steps for Unhandled Exception Errors:

Additional Information
Was this article helpful?