Q: I loaded a BAM file and don't see anything. What's wrong?
The most common cause for this is a mismatch in chromosome names between the BAM file and the IGV genome it is being viewed against. The workaround is to create an alias file in 2-column tab-delimited format. To see how to create this alias file, see Creating a Chromosome Name Alias File in the IGV User Guide.
Q: I tried to compute coverage with igvtools and nothing was created. What's wrong?
Check the console output for error messages. The most common causes for this are the two problems noted above for loading BAM files, and attempting to compute coverage on an unsorted file.
Genomes and Data Files
Q: How do I add [my favorite genome] to IGV?
Q: I imported a genome annotation file and don't see the annotations. What's wrong?
The most common cause for this is a mismatch in the sequence (chromosome) names between the annotation file (e.g., GFF or BED) and FASTA files. The workaround is to either rename the chromosome names in one of the files (usually the annotation file), or to create an alias file in 2-column tab-delimited format. To see how to create this alias file, see Creating a Chromosome Name Alias File in the IGV User Guide.
Q: How do I make a genome available to my colleagues on my server?
Follow the steps here to upload your genome to your server and configure it for sharing.
Q: How do I visualize [my favorite data type] in IGV?
Q: How do UCSC's genome release numbers correspond to those of other organizations, such as NCBI?
See the FAQ on the UCSC Genome Bioinformatics web site: http://genome.ucsc.edu/FAQ/FAQreleases#release1
Accessing HDF5 (.h5) files requires a native C library. Versions of this library for Mac Snow Leopard and 64-bit Windows are not distributed with IGV. To view the .h5 files on these operating systems you must change your Java preferences to use a 32-bit JDK rather than the 64-bit JDK that is installed by default.
For this reason, and others, we have replaced the HDF5 file format with the TDF file format. If you have the source files used to create the .h5 files, we encourage you to replace the .h5 files with .tdf files (see the toTDF and count commands in igvtools).
Q: Does IGV assume log2(ratio) or absolute values for copy number?
IGV looks for the presence of negative numbers. If it finds them, it assumes that the data is log2(tumor/normal). If it does not find negative numbers, it assumes that the values are absolute, with 2 as the center. These assumptions are used to set the heatmap legend; the legend can, however, be changed manually.
Q: I unzipped igvtools and double clicked the "igv.jar". Nothing happened.
The igvtools jar is a command line program and must be run from a Linux or Mac terminal, or a Windows command prompt. To start up a GUI interface for the program, launch igvtools from the IGV File menu, or use the script igvtools_gui, igvtools_gui.bat, or igvtools_gui.command depending on platform. See the readme for more details.
Q: When I try to run igvtools I get an error like the one below:
Error occurred during initialization of VM
The scripts (igvtools and igvtools.bat) include a memory flag on the startup line that needs to be reduced. To fix this problem edit the igvtools file (igvtools.bat on Windows) and reduce the amount of memory requested. For example, to reduce the amount from the default 4GB to 2GB edit the startup line as follows
java -Xmx2g -jar `dirname $0`/igvtools.jar $*
See the java documentation for more details.
Q: I tried to sort/index a BAM file and it did not work.
IGVTools do not work with BAM files. To sort or index BAM files use samtools.
Q: How do I export a sequence in which I am interested?
To export a sequence, first define the region using the Region of Interest tool.
Q: When I zoom into the sequence, why do I see little squares instead of the bases?
The squares appear when the sequence is unavailable. If you are using a genome stored on the IGV data server, you must be connected to the Internet to view the sequence.
Q: How do I clear IGV from my Java cache so that I can update my IGV?
Q: How do I clear IGV's genome cache?
A) View>Preferences>Advanced>Clear Genome Cache
Q: A gene locus often produces several splicing isoforms, so how do I show different splicing isoforms for a single gene locus in IGV?
Right-click on the track and select Expand Track, or click the triangle icon () on the left-hand side of the track. This displays overlapping features in separate rows so that separate isoforms are visible.
Q. When I launch IGV with the 2GB or 10GB options, I get an error that says, "Could not create the Virtual Machine." I have plenty of memory on my computer so why is this happening?
You need both a 64-bit OS and a 64-bit version of Java. On many computers, 32-bit Java is installed by default, even if the OS is 64-bit.
Q: Can I use an array list to display selected tracks in IGV?
Yes. See Sorting and Filtering by Track List.
There is a known issue when proxies must be used with a new installation of IGV. When you are behind a firewall launching IGV for the first time, IGV might refuse to launch with an error that the genome server cannot be contacted. If this occurs, the workaround is to manually place a genome in the IGV genome cache directory by performing the following steps:
1. Download the hg18.genome file from
2. Save the above file to the following directory, creating it if needed.
<user home>/igv/genomes (PCs and Linux)
<user home>/.igv/genomes (Macs -- note the dot in front of igv)
After starting up you can set your proxy settings in the preferences window after starting up (menu View > Preferences > Proxy tab).