Understanding Download Errors in VEXcode IQ

There are four potential error messages a user might see when downloading a project to a VEX IQ (1st generation) or (2nd generation) Brain.

Please skip to the section of this article with the error message that you are seeing.


Your program failed to download

VEXcode IQ error prompt that reads Your program failed to download. Please try again. The prompt has a blue OK button in its bottom right corner.

You are seeing the error message above because the Brain lost its connection during the download process.

Check these possible reasons before trying again: 


Unable to access Cloud Compiler servers

VEXcode IQ error prompt that reads Unable to access Cloud Compiler servers. Check http://status.vexcode.cloud/ for more details. The prompt has a Show Details button below, and it has a blue OK button in its bottom right corner.

Previous VEXcode IQ Cloud Compiler error prompt after the Show Details button has been selected. A new message reads If the Cloud Compiler servers are currently running, your local network may be blocking access to the VEXcode Cloud Compiler servers.

This error will be shown when VEXcode IQ cannot connect to the remote Cloud Compiler server while working on ChromeOS, iOS, and Android.

You can visit http://status.vexcode.cloud to see if the Cloud Compilers are currently running as well.


Compiler process has timed out

VEXcode IQ error prompt that reads Compiler process has timed out. Please try again. The prompt has a blue OK button in its bottom right corner.

This error is shown when there is no response from the Cloud Compiler server. It could be that the server is having a load issue. Please wait a minute and try again.


Error compiling your program

VEXcode IQ error prompt that reads Error compiling your program. The prompt has a Show Details button below, and it has a blue OK button in its bottom right corner.

You are seeing the error message above because an unexpected error occurred. The “Show Details” area will give technical debugging information that can be used to troubleshoot your issue.

Follow these steps: 

  1. Click "Show Details" in the error message window. 
    Previous VEXcode IQ Program Compilation error prompt now with the Show Details button highlighted.
  2. Highlight and copy all of the details shown

    Previous VEXcode IQ Program Compilation error prompt after the Show Details button has been selected. A new message contains an error message with information about how the program failed. The error message is highlighted to indicate that it should be copied and pasted into a feedback form.

  3. Click the Feedback button at the top right side of the screen in VEXcode IQ and paste the details into the ticket where it says, “Your message…” 
  4. Make sure that you click to include your diagnostic and usage data. Type in your email address in case the development team may need to reach out for more information, then click "Send." 

VEXcode IQ Feedback Window with the Email Address and Include Diagnostics fields highlighted. There is a check box to choose between including an email address to recieve a response, or not including an email address. Below, there is another check box to include diagnostic and usage data. Both of the check boxes are checked.

For more information, help, and tips, check out the many resources at VEX Professional Development Plus

Last Updated: