Troubleshooting Requests

We now support our users through OmicsForum. Please join OmicsForum and ask questions or share experiences there. Together, we can help each other and our community.

There are many possible reasons for your data analysis not behaving as expected. In most cases, the issues are related to your data and the specific steps you have taken, not with MetaboAnalyst itself. Make sure you have provided enough details (data + steps + parameters) so we can reproduce the issues from our end. For more efficient communication with our team, please read these tips below:

  • Have you read the FAQs, Data Format and Tutorials?
    These resources provide detailed explanations for common questions received from users. Please first go through these resources as listed on the left bar.
  • Have you tried our example data to see if the issue still exists?
    Most of the time, the issue is related to improper data format. Although we try to give informative error messages during the data uploading stage, there are always exceptions. Here are three tips:
    1. Open your file in a text editor (not a spreadsheet program) to see the details - are these values comma separated (.csv) or tab separated (.txt)?
    2. You may need to search "How to save my file in a .csv format" to get more detailed instructions;
    3. We offered a wide variety of example datasets, please choose the one that matches your data type to see if the issue still appears. Download and open the data in a text editor for details.
  • Did you provide enough details so that the issue can be reproduced?
    Remote troubleshooting requires more information in order to figure out the exact cause of the issue. Please
    1. Indicate which example data you used, or provide a copy of your data
    2. Document all steps leading to the issue. Sometimes screenshots may be necessary
  • Support for new features
    Bugs are usually dealt with immediately (or within 3 days) once we have received and validated the bug report. New features will be evaluated based on the overall feedback from other users. Top ranked features will be added as minor release (3-month or 6-month period) depending on the available resources.
If you still need help, please send your email together with the required information (data + steps + parameters) to: zhiqiang.pang [at] or jeff.xia [at] Make sure your question is specific to MetaboAnalyst. Asking for statistical consultations or very general questions (i.e. how to analyze your data) will be ignored, due to limited time availability.

Genome Canada Genome Quebec NIH NSERC CRC
Processing ....

This may take a while to complete, please be patient....

Your session is about to expire!

You will be logged off in seconds.

Do you want to continue your session?