Due to scheduled network maintenance work, all Ensembl websites will be briefly unavailable on Wednesday 17 January 2024 between 12:00 and 13:00 (GMT).

Variant Effect Predictor Input form


When you reach the VEP web interface, you will be presented with a form to enter your data and alter various options.

Data input

  1. First select the correct species for your data. Ensembl hosts many vertebrate genomes; genomes for plants, protists and fungi can be found at Ensembl Genomes.
  2. You can optionally choose a name for the data you upload - this can make it easier for you to identify jobs and files that you have uploaded to the VEP at a later point.
  3. You have three options for uploading your data:

    • File upload - click the "Choose file" button and locate the file on your system
    • Paste file - simply copy and paste the contents of your file into the large text box
    • File URL - point the VEP to a file hosted on a publically accessible address. This can be either a http:// or ftp:// address.
    Once you have uploaded some data, you can select it as the input for future jobs by choosing the data from the drop down menu.

    The format of your data is automatically detected; see the examples or the input format documentation.

  4. For pasted data you can get an instant preview of the results of your first variant by clicking the button that appears when you paste your data. This quickly shows you the consequence type, the IDs of any overlapping variants, genes, transcripts and regulatory features, as well as SIFT and PolyPhen predictions. To see the full results set submit your job as normal.
  5. For some species you can select which transcript database to use. The default is to use Ensembl transcripts, which offer the most rich annotation through VEP.

    GENCODE Basic is a subset of the GENCODE gene set, and is intended to provide a simplified, high-quality subset of the GENCODE transcript annotations that will be useful to the majority of users. GENCODE Basic includes all genes in the GENCODE gene set, with a representative subset of the transcripts (splice variants).

    You can also select to use RefSeq transcripts from the otherfeatures database; note though that these transcripts are simply aligned to the reference genome and the database is missing much of the annotation found when using the main Ensembl database (e.g. protein domains, CCDS identifiers).


Identifiers

VEP can provide additional identifiers for genes, transcripts, proteins and variants.
  • Gene symbol

    Add the gene symbol for the gene to the output. This will typically be, for example, the HGNC identifier for genes in human. Equivalent to --symbol in the VEP script.

  • Transcript version

    Add the transcript version to the transcript identifier. Equivalent to --transcript_version.

  • CCDS

    Add the Consensus CDS transcript identifier where available. Equivalent to --ccds.

  • Protein

    Add the Ensembl protein identifer (ENSP). Equivalent to --protein.

  • UniProt

    Add identifiers for translated protein products from three UniProt-related databases (SWISSPROT, TREMBL and UniParc). Equivalent to --uniprot.

  • HGVS

    Generate HGVS identifiers for your input variants relative to the transcript coding sequence (HGVSc) and the protein sequence (HGVSp). Equivalent to --hgvs.


Variants and frequency data

VEP can also search the Ensembl database for known variants that are co-located with variants from your input data.
  • Find co-located known variants - report known variants from the Ensembl Variation database that overlap with your input. A list of variant sources imported can be viewed here. Note that this feature is only available for species with an Ensembl Variation database. Equivalent to --check_existing.

    VEP will by default compares the alleles of your input variant to that of the existing variant; VEP will only report the existing variant ID if none of the alleles in your input variant are novel.

    For example, if your input variant has alleles A/G, and the existing variant has alleles A/T, then the existing variant will not be reported. If instead your input variant has alleles A/T, then the existing variant will be reported.

    To disable this allele matching, select the option "Yes but don't compare alleles" for the option "Find co-located known variants".

    For known variants VEP can also provide PubMed IDs of publications citing the variant (equivalent to --pubmed).

  • Variant synonyms

    Report known synonyms for co-located variants.

  • Frequency data for co-located variants

    VEP can also report allele frequency (AF) data for existing variants from several major genotyping projects, the 1000 Genomes Project, the NHLBI-ESP and gnomAD; this only applies when you have selected human as your species.

    • 1000 Genomes global - the combined phase 3 population (i.e. all individuals from all populations). Equivalent to --af
    • 1000 Genomes continental - the four continent-level populations - AFR (African), AMR (American), ASN (Asian) and EUR (European). Equivalent to --af_1kg
    • ESP - AA (African American) and EA (European American) populations. Equivalent to --af_esp
    • gnomAD - combined, AFR, AMR, ASJ, EAS, FIN, NFE, OTH, SAS populations. Equivalent to --af_gnomad

  • PubMed IDs for citations of co-located variants

    Report the PubMed IDs of any publications that cite the co-located variant(s).

  • Include flagged variants

    Variants flagged as failed by the Ensembl Variation quality control.


Additional annotations

  • Transcript biotype

    Add the transcript biotype to the output. Equivalent to --biotype in the VEP script.

  • Exon and intron numbers

    Report the exon or intron number that a variant falls in as NUMBER / TOTAL, i.e. exon 2/5 means the variant falls in the 2nd of 5 exons in the transcript. Equivalent to --numbers.

  • Transcript support level

    Report the transcript support level of the overlapped transcript. Equivalent to --tsl.

  • APPRIS

    Report the APPRIS score of the overlapped transcript. Equivalent to --appris.

  • Identify canonical transcripts

    Add a flag to the output indicating if the reported transcript is the canonical transcript for the gene. Equivalent to --canonical.

  • Upstream/Downstream distance (bp)

    Change the distance to assign the upstream and downstream consequences. Equivalent to --distance.

  • miRNA structure

    Determines where in the secondary structure of a miRNA a variant falls. Equivalent to the VEP plugin miRNA.


  • Protein domains

    Report protein domains from PDBe, Pfam, Prosite and InterPro that overlap input variants. Equivalent to --domains.


  • Get regulatory region consequences

    In addition to predicting consequences with overlapping transcripts, VEP can find overlaps with known regulatory regions as determined in the Ensembl Regulatory build.
    Using this option, VEP will also report if a variant falls in a transcription factor binding motif, and give a score that reflects whether the altered motif sequence is more or less similar to the consensus.
    Get regulatory consequences is equivalent to --regulatory.


  • Phenotypes

    Report the phenotypic data overlapping the genomic features. This functionality is provided by the Phenotypes plugin.
    For more information on the imported phenotypic data for genes, variation and QTLs see our phenotype documentation.
    Note: This web functionality is not reporting cancer phenotypic data this release. However the cancer phenotypic data is available in the command line version.

  • DisGeNET

    Report Variant-Disease-PMID associations from the DisGeNET database. This functionality is provided by the DisGeNET plugin.
    Note: This web functionality is reporting the unique disease names.

  • Mastermind

    Uses the Mastermind Genomic Search Engine to report variants that have clinical evidence cited in the medical literature. This functionality is provided by the Mastermind plugin.
    Note: This web functionality is only reporting the URL to the Mastermind Genomic Search Engine webpage.


Predictions

  • SIFT predictions

    SIFT predicts whether an amino acid substitution affects protein function based on sequence homology and the physical properties of amino acids. Only available in popular species. For both SIFT and PolyPhen VEP can report either a score between 0 and 1, a prediction in words, or both. Equivalent to --sift.

  • PolyPhen predictions

    PolyPhen is a tool which predicts possible impact of an amino acid substitution on the structure and function of a human protein using straightforward physical and comparative considerations. Equivalent to --polyphen.

  • dbNSFP

    Retrieves data for missense variants from dbNSFP. Equivalent to the VEP plugin dbNSFP.

  • Condel

    Calculates the Consensus Deleteriousness (Condel) score for a missense mutation based on the pre-calculated SIFT and PolyPhen-2 scores. Equivalent to the VEP plugin Condel.

  • LoFtool

    Provides a rank of genic intolerance and consequent susceptibility to disease based on the ratio of Loss-of-function (LoF)to synonymous mutations. Equivalent to the VEP plugin LoFtool.


  • dbscSNV

    Retrieves data for splicing variants from dbscSNV. Equivalent to the VEP plugin dbscSNV.

  • MaxEntScan

    Get splice site predictions from MaxEntScan. Equivalent to the VEP plugin MaxEntScan.

  • SpliceAI

    Pre-calculated annotations from SpliceAI a deep neural network, developed by Illumina, Inc that predicts splice junctions from an arbitrary pre-mRNA transcript sequence. Used for non-commercial purposes. This functionality is provided by the SpliceAI plugin.


  • BLOSUM62

    Looks up the BLOSUM 62 substitution matrix score for the reference and alternative amino acids predicted for a missense mutation. Equivalent to the VEP plugin Blosum62.

  • Ancestral allele

    Retrieves ancestral allele sequences from a FASTA file. Ensembl produces FASTA file dumps of the ancestral sequences of key species. Equivalent to the VEP plugin AncestralAllele.


Filtering options

VEP allows you to pre-filter your results e.g. by MAF or consequence type. Note that it is also possible to perform equivalent operations on the results page for VEP, so if you aren't sure, don't use any of these options!
  • By frequency

    Filter variants by minor allele frequency (MAF). Two options are provided:

    • Exclude common variants

      Filter out variants that are co-located with an existing variant that has a frequency greater than 0.01 (1%) in the 1000 Genomes global population. Equivalent to --filter_common in the VEP script.

    • Advanced filtering

      Enabling this option allows you to specify a population and frequency to compare to, as well whether matching variants should be included or excluded from the results.

  • Return results for variants in coding regions only

    Exclude variants that don't fall in a coding region of a transcript. Equivalent to --coding_only.

  • Restrict results

    For many variants VEP will report multiple consequence types - typically this is because the variant overlaps more than one transcript. For each of these options VEP uses consequence ranks that are subjectively determined by Ensembl. This table gives all of the consquence types predicted by Ensembl, ordered by rank. Note that enabling one of these options not only loses potentially relevant data, but in some cases may be scientifically misleading. Options:

    • Show one selected consequence

      Pick one consequence type across all those predicted for the variant; the output will include transcript- or feature-specific information. Consequences are chosen by the canonical, biotype status and length of the transcript, along with the ranking of the consequence type according to this table. This is the best method to use if you are interested only in one consequence per variant. Equivalent to --pick.

    • Show one selected consequence per gene

      Pick one consequence type for each gene using the same criteria as above. Note that if a variant overlaps more than one gene, output for each gene will be reported. Equivalent to --per_gene.

    • Show only list of consequences per variant

      Give a comma-separated list of all observed consequence types for each variant. No transcript-specific or gene-specific output will be given. Equivalent to --summary.

    • Show most severe per variant

      Only the most severe of all observed consequence types is reported for each variant. No transcript-specific or gene-specific output will be given. Equivalent to --most_severe.


Advanced options

The VEP web interface allows you to use/setup advanced options:

  • Buffer size

    By default VEP process the variants by blocks of 5000 (i.e. what we call "buffer size").
    In some cases, reducing the size of the blocks (buffer size) could prevent memory issues for large VEP queries (e.g. use of regulatory data, many plugins or custom annotations).
    This is why the maximum buffer size is automatically set to 500 on the VEP Web interface when the "Regulatory data" option is selected.

  • Right align variants prior to consequence calculation

    By default VEP performs consequence calculation at the given input coordinates.
    Optionally, VEP can shift insertions and deletions found within repeated regions as far as possible in the 3' direction, normalising output.


Jobs

Once you have clicked "Run", your input will be checked and submitted to the VEP as a job. All jobs associated with your session or account are shown in the "Recent Tickets" table. You may submit multiple jobs simultaneously.

The "Jobs" column of the table shows the current status of the job.

  • Queued - your job is waiting to be submitted to the system
  • Running - your job is currently running
  • Done - your job is finished - click the [View results] link to be taken to the results page
  • Failed - there is a problem with your job - click the magnifying glass icon to see more details

You may delete a job by clicking the trash can icon . If you are logged in to Ensembl, you can save the job by clicking the save icon .

You may also resubmit a job (for example, to re-run with the same data but change some parameters) by clicking the edit icon .

You can see a summary of the options that you selected for your VEP job by clicking on the magnifying glass icon .