.. _listupload:


Upload a list
-----------------


To upload a list simply click on the ‘Lists’ tab and then select the ‘Upload’ subtab:


.. image:: ../../_images/listtab.png




On the list upload form, you can select the following -  see the screenshot below:


1. The type of list - from the drop-down list select the type of list you are uploading, e.g. gene
2. The organism your items are from.  It is possible to upload a list containing items from more than one organism - in this case, set the organism drop-down to ‘Any’.
3. Either type-in, paste-in or upload your list from a file (4).  Note: to upload from a file the file must be a .txt file.  Although the type of item you are uploading must be the same, the type of identifier can differ - e.g. you can enter a mixture of gene symbols, identifiers and names.
5. Match on case: this option is useful in some cases, for example, if you are entering gene symbols for Drosophila melanogaster, where the case matters.
6. Create list: this will activate the identifier resolution system, where the identifiers you have entered are checked against the InterMine database.  Any discrepancies will be shown on the next page.




.. image:: ../../_images/listuploadform.png






.. _listconfirmationpage:


The Identifier Resolution page
-----------------------------------------


When you upload a list, all the identifiers you enter will be checked against the database to see if they can be found.  InterMine has a sophisticated identifier resolution system that will help you map your identifiers to the correct identifier in the database.  This is particularly useful if there have been some gene model changes and some of your identifiers are now out of date.  The identifier resolution system will report the following:


1. The number of exact matches found to entries in the database.
2. The identifiers that match a synonym but not a main or primary identifier.
3. Identifiers that match more than one database entry.
4. Identifiers that match a different type - e.g if you enter a protein identifier when you are uploading a list of genes.


The identifier resolution system is also used during InterMine data releases to check that all the identifiers in your lists are still valid.  Any discrepancies found will be reported to you and will be asked to ‘upgrade your lists’.  The **Verify identifier matches** page allows you to resolve any conflicts and decide which genes you want in your list.  By default, exact matches are automatically added to your list. For any other type of match you can choose to either add all of them to your list or analyse each one individually and add as required.


.. image:: ../../_images/listresolution.png




**Synonym match:**  the identifier you entered, FBgn0001251 is a synonym of FBgn0001325. Your identifier is old and gene now has a new identifier.


**Duplicates:** The identifier you entered, tramtrack, matches multiple identifiers.  In this case the identifiers are from different species and this could have been avoided by selecting the organism on the list upload page.


**Converted types:**  You have selected to upload a list of genes but one of your identifiers is for a protein, TWIST_DROME.  The gene identifier for this protein is given.