{"__v":11,"_id":"5741e66971cca10e0062101d","category":{"__v":3,"_id":"5671979d60c8e70d006c9760","pages":["567199111b6b730d008b4828","567329a858c4890d00bb5461","56d4a1908001e30b00896f54"],"project":"55faf11ba62ba1170021a9a7","version":"55faf11ba62ba1170021a9aa","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-12-16T16:55:57.779Z","from_sync":false,"order":10,"slug":"add-files-to-a-project","title":"ADD FILES TO A PROJECT"},"parentDoc":null,"project":"55faf11ba62ba1170021a9a7","user":"5613e4f8fdd08f2b00437620","version":{"__v":37,"_id":"55faf11ba62ba1170021a9aa","project":"55faf11ba62ba1170021a9a7","createdAt":"2015-09-17T16:58:03.490Z","releaseDate":"2015-09-17T16:58:03.490Z","categories":["55faf11ca62ba1170021a9ab","55faf8f4d0e22017005b8272","55faf91aa62ba1170021a9b5","55faf929a8a7770d00c2c0bd","55faf932a8a7770d00c2c0bf","55faf94b17b9d00d00969f47","55faf958d0e22017005b8274","55faf95fa8a7770d00c2c0c0","55faf96917b9d00d00969f48","55faf970a8a7770d00c2c0c1","55faf98c825d5f19001fa3a6","55faf99aa62ba1170021a9b8","55faf99fa62ba1170021a9b9","55faf9aa17b9d00d00969f49","55faf9b6a8a7770d00c2c0c3","55faf9bda62ba1170021a9ba","5604570090ee490d00440551","5637e8b2fbe1c50d008cb078","5649bb624fa1460d00780add","5671974d1b6b730d008b4823","5671979d60c8e70d006c9760","568e8eef70ca1f0d0035808e","56d0a2081ecc471500f1795e","56d4a0adde40c70b00823ea3","56d96b03dd90610b00270849","56fbb83d8f21c817002af880","573c811bee2b3b2200422be1","576bc92afb62dd20001cda85","5771811e27a5c20e00030dcd","5785191af3a10c0e009b75b0","57bdf84d5d48411900cd8dc0","57ff5c5dc135231700aed806","5804caf792398f0f00e77521","58458b4fba4f1c0f009692bb","586d3c287c6b5b2300c05055","58ef66d88646742f009a0216","58f5d52d7891630f00fe4e77"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-05-22T17:03:37.808Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"##Overview\n\nYou can tag your files with keywords or strings on the CGC to make it easier to identify and organize files you’ve imported from public datasets. The tags will help you visually keep track of files as you import them into your project from the Data Browser or from the Public Reference Files repository. You can also tag files you copy between projects. These tags allow you to sort and filter files within a project and on the **DRAFT** task page.\n[block:callout]\n{\n  \"type\": \"success\",\n  \"body\": \"Learn more about tagging files as you upload them via the [CGC Uploader](upload-via-the-cgc-uploader), via the [command line](upload-via-the-command-line), or from an [FTP or HTTP(S) server](upload-from-an-ftp-server).\",\n  \"title\": \"Tag files during upload\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"On this page:\",\n  \"body\": \"* [Add tags when copying files](#section-add-tags-when-copying-files)\\n * [Copying files from the Data Browser](#section-copying-files-from-the-data-browser)\\n * [Copying files from the Public Reference Files repository](#section-copying-files-from-the-public-reference-files)\\n* [Manage file tags within a project](#section-manage-file-tags-within-a-project)\\n * [Add or edit tags for your files](#section-add-or-edit-tags-for-your-files)\\n * [Remove tags from your files](#section-remove-tags-from-your-files)\\n * [Filtering tags within a project](#section-filtering-tags-within-a-project)\\n * [Copying files between projects](#section-copying-files-between-projects)\"\n}\n[/block]\n##Add tags when copying files\n\n###Copying files from the Data Browser\n\nWhen you [copy files from the Data Browser](the-data-browser#section-copy-files-to-project), you will be prompted to tag your files as you import them into a project.\n\nTo tag your files, first copy them from the Data Browser to your project:\n\n1. Navigate to the Data Browser by selecting **Data** from the top navigation bar and clicking on **Data Browser** from the drop-down menu. \n2. [Populate the Data Browser with a query](the-data-browser#section-queries-on-the-data-browser).\n3. Select the **File** node with the files you wish to copy, and click **+Copy files to project**, as shown below.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/TIIAQwSy6uuqBjHiwrAA_Screen%20Shot%202016-05-20%20at%2011.14.58%20AM.jpeg\",\n        \"Screen Shot 2016-05-20 at 11.14.58 AM.jpeg\",\n        \"2692\",\n        \"1364\",\n        \"\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nA pop-up will appear, indicating which files will be copied.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/8hUJZrv5SYSRSvXGIMIG_Screen%20Shot%202016-05-09%20at%2012.16.06%20PM.jpeg\",\n        \"Screen Shot 2016-05-09 at 12.16.06 PM.jpeg\",\n        \"636\",\n        \"622\",\n        \"#326b4b\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n4. Click on your desired project from the **Projects** list, as shown above. You can also use the search box to find your project.\n\nIn the **Copy** dialog which appears, you see how many files will be successfully imported into your project.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/UDe2x7A9QkWLWBNZYVb8_Screen%20Shot%202016-05-20%20at%2011.56.08%20AM.jpeg\",\n        \"Screen Shot 2016-05-20 at 11.56.08 AM.jpeg\",\n        \"860\",\n        \"602\",\n        \"#337e53\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"success\",\n  \"body\": \"You can check you're importing your files into the right project by clicking on the hyperlinked project name to open your project in a new tab.\"\n}\n[/block]\n5. Enter one or more tags, separated by commas or by the return key, into the box below **Tag files**. Any previously used tags in your selected project will be autosuggested.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/3BfUIhInSIyCg1XRLvjO_Screen%20Shot%202016-05-20%20at%2012.16.35%20PM.jpeg\",\n        \"Screen Shot 2016-05-20 at 12.16.35 PM.jpeg\",\n        \"916\",\n        \"600\",\n        \"#357953\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n6. When you are finished tagging your files, click** Copy selected files**.\n\nThe files will display in the **Files** tab of your project. Learn more about [file tags within a project](#section-manage-file-tags-in-a-project) below.\n\nSince there are two file nodes, **Files** and **Files1**, in the example query above, you can copy the files separately. Now that all the Primary tumor files from **Files** has been copied into the project, you can copy the blood derived normal files from **Files1**, as shown below.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/kP0rOvcMQ4CL62GIaMMs_Screen%20Shot%202016-05-20%20at%2012.20.31%20PM.jpeg\",\n        \"Screen Shot 2016-05-20 at 12.20.31 PM.jpeg\",\n        \"862\",\n        \"682\",\n        \"\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nNote that the previously used tags in the target project will be auto-suggested.\n\n<div align=\"right\"><a href=\"#top\">top</a></div>\n\n##Copying files from the Public Reference Files repository\n\nWhen you copy files from the [**Public Reference Files** repository](copy-files-to-a-project), you will be prompted to tag your files as you import them into a project.\n\nTo tag your files, first copy them from the **Public Reference Files** to your project:\n\n1. Navigate to **Public Reference Files** by selecting **Data** from the top navigation bar and clicking **Public Reference Files** from the drop-down menu.\n2. In the file picker which appears, click the checkbox next to your desired files to select them, as shown below.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/QlMg3UDSlSSVftzol3Qw_Screen%20Shot%202016-05-11%20at%2010.54.07%20AM.jpeg\",\n        \"Screen Shot 2016-05-11 at 10.54.07 AM.jpeg\",\n        \"2762\",\n        \"1292\",\n        \"#43616f\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n3. Click **Copy to Project**, and select your desired project from the drop-down menu.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/HiKH94QtTzqLYMjsPWxV_Screen%20Shot%202016-05-20%20at%202.32.54%20PM.jpeg\",\n        \"Screen Shot 2016-05-20 at 2.32.54 PM.jpeg\",\n        \"922\",\n        \"480\",\n        \"#dd7677\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n4. In the pop-up which appears, check you're copying the correct number of files into your desired project.\n5. Enter one or more tags, separated by commas, into the box. Any previously used tags in your selected project will be autosuggested.\n6. Click **OK** to finish importing files into your project.\n\nThe files will display in the **Files** tab of your project. Learn more about [file tags within a project](#section-manage-file-tags-in-a-project) below.\n\n<div align=\"right\"><a href=\"#top\">top</a></div>\n\n##Manage file tags within a project\n\nTo manage file tags within your project, first [navigate to your project](view-a-project). From the **Files** tab of your project, you can:\n  * [Add or edit tags](link) for your files\n  * [Remove tags](link) from your files\n  * [Filter files](link) via their tags\n\n###Add or edit tags for your files\n\nTo add tags to files within a project:\n\n1. Click the checkbox next to your desired files to select them, as shown below.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/veEs2v0OT8K47NTHitmC_Screen%20Shot%202016-05-09%20at%2012.56.12%20PM.jpeg\",\n        \"Screen Shot 2016-05-09 at 12.56.12 PM.jpeg\",\n        \"2756\",\n        \"1026\",\n        \"#446471\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n2. Click **Tags**.\n3. In the pop-up box, enter one or more tags separated by commas. Any previously used tags in your selected project will be autosuggested.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/nAyy1AtxSaifmAJHBhFk_copy%20Screen%20Shot%202016-05-09%20at%2012.38.44%20PM%20(1).jpg\",\n        \"copy Screen Shot 2016-05-09 at 12.38.44 PM (1).jpg\",\n        \"2764\",\n        \"1016\",\n        \"#4f7dbb\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"When you add tags to files which already have tags, the new tags will have solid background colors in the **Tag files** pop-up. This is to help you distinguish between old and new tags.\"\n}\n[/block]\n4. Click **Apply** to finish tagging.\n\nYou have now added tags to your files. In the example below, the **WXS** tag has been added to all files. The old tags on each file remain attached to the respective files.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/Je7QmLysRDCuUXbPXhg7_Screen%20Shot%202016-05-09%20at%203.13.22%20PM%20(1).jpeg\",\n        \"Screen Shot 2016-05-09 at 3.13.22 PM (1).jpeg\",\n        \"2762\",\n        \"1010\",\n        \"#44626a\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n###Remove tags from your files\n\nTo remove tags from files in your project:\n\n1. Click the checkbox next to your desired files to select them, as shown below.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/e28ZZc2sTOiHcQkqOvtD_Screen%20Shot%202016-05-09%20at%201.00.20%20PM.jpeg\",\n        \"Screen Shot 2016-05-09 at 1.00.20 PM.jpeg\",\n        \"2764\",\n        \"1008\",\n        \"\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n2. Click **Tags**.\n3. In the pop-up box, click the **x** next to the tags you want to delete.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/dr2zdnXCT0CVarSy6uxF_copy%20Screen%20Shot%202016-05-09%20at%201.01.20%20PM%20(1).jpg\",\n        \"copy Screen Shot 2016-05-09 at 1.01.20 PM (1).jpg\",\n        \"780\",\n        \"586\",\n        \"#f66710\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n4. Click **Apply** to finish removing tags.\n\nYou have now removed tags from your files. In the example below, the VCF tag has been removed from the selected files. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/BGNgkzffQK22L5QSAcT0_Screen%20Shot%202016-05-09%20at%201.02.00%20PM%20(1).jpeg\",\n        \"Screen Shot 2016-05-09 at 1.02.00 PM (1).jpeg\",\n        \"2756\",\n        \"756\",\n        \"#446466\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n<div align=\"right\"><a href=\"#top\">top</a></div>\n\n###Filtering tags within a project\n\nYou can filter tags within a project from the **File Picker** or the **Files** tab.\nThe process for both is the same. Simply navigate to either the **File Picker** (as shown below) or the **Files** tab to start.\n\nTo filter tags in the **File Picker**:\n\n1. Access the **File Picker** by navigating to your desired project, selecting the **Files** tab, and clicking **+Add files**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/a3QOAR1XSgSiINE4XqTY_Screen%20Shot%202016-05-09%20at%203.32.30%20PM.jpeg\",\n        \"Screen Shot 2016-05-09 at 3.32.30 PM.jpeg\",\n        \"2692\",\n        \"1114\",\n        \"#c07995\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n2. Click on **Tags: All to set your filter(s)**, as shown below.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/bTbhXyAsRkqcyIzIaIel_Screen%20Shot%202016-05-09%20at%203.32.30%20PM.jpeg\",\n        \"Screen Shot 2016-05-09 at 3.32.30 PM.jpeg\",\n        \"2692\",\n        \"1114\",\n        \"#c07995\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nFiles matching your filter should display in the **File Picker**.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"You can also filter by clicking a tag listed below the respective file name. For example, clicking known **indels** will filter for all files with the known **indels** tag.\"\n}\n[/block]\n<div align=\"right\"><a href=\"#top\">top</a></div>\n\n###Copying files between projects\n \nWhen you copy files between projects, you will be prompted to tag your files as you import them into a project.\n\nTo copy files between projects:\n\n1. Navigate to your desired project by selecting **Projects** from the top navigation bar and clicking **View all** from the drop-down menu.\n2. Select the project which contains the files you wish to copy.\n3. From the project dashboard, click the **Files** tab. This will display a list of all the files in your project.\n4. Click the checkbox next to your desired files to select them, as shown below.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/LMVqJhB2R1embqyOjkzA_Screen%20Shot%202016-05-09%20at%203.55.45%20PM.jpeg\",\n        \"Screen Shot 2016-05-09 at 3.55.45 PM.jpeg\",\n        \"2756\",\n        \"916\",\n        \"\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n5. Click **Copy to** and select your desired project from the drop-down menu.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/DRR6rfWAR1u0QckzHFPr_Screen%20Shot%202016-05-09%20at%203.56.23%20PM.jpeg\",\n        \"Screen Shot 2016-05-09 at 3.56.23 PM.jpeg\",\n        \"2772\",\n        \"1030\",\n        \"#425c64\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n6. In the pop-up box, check you're copying the correct number of files into your desired project.\n7. Enter one or more tags, separated by commas, into the box. You'll see existing tags for the files, and any previously used tags in your selected project will be autosuggested.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/OLedYfPnSeKwRChkoVhN_Screen%20Shot%202016-05-09%20at%203.57.25%20PM.jpeg\",\n        \"Screen Shot 2016-05-09 at 3.57.25 PM.jpeg\",\n        \"1136\",\n        \"514\",\n        \"#bc7d7e\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n8. Click **Ok** to finish importing files into your project.\n\nThe files will display in the **Files** tab of your selected project.\n \n<div align=\"right\"><a href=\"#top\">top</a></div>","excerpt":"<a name=\"top\"></a>","slug":"tag-your-files","type":"basic","title":"Tag your files"}

Tag your files

<a name="top"></a>

##Overview You can tag your files with keywords or strings on the CGC to make it easier to identify and organize files you’ve imported from public datasets. The tags will help you visually keep track of files as you import them into your project from the Data Browser or from the Public Reference Files repository. You can also tag files you copy between projects. These tags allow you to sort and filter files within a project and on the **DRAFT** task page. [block:callout] { "type": "success", "body": "Learn more about tagging files as you upload them via the [CGC Uploader](upload-via-the-cgc-uploader), via the [command line](upload-via-the-command-line), or from an [FTP or HTTP(S) server](upload-from-an-ftp-server).", "title": "Tag files during upload" } [/block] [block:callout] { "type": "warning", "title": "On this page:", "body": "* [Add tags when copying files](#section-add-tags-when-copying-files)\n * [Copying files from the Data Browser](#section-copying-files-from-the-data-browser)\n * [Copying files from the Public Reference Files repository](#section-copying-files-from-the-public-reference-files)\n* [Manage file tags within a project](#section-manage-file-tags-within-a-project)\n * [Add or edit tags for your files](#section-add-or-edit-tags-for-your-files)\n * [Remove tags from your files](#section-remove-tags-from-your-files)\n * [Filtering tags within a project](#section-filtering-tags-within-a-project)\n * [Copying files between projects](#section-copying-files-between-projects)" } [/block] ##Add tags when copying files ###Copying files from the Data Browser When you [copy files from the Data Browser](the-data-browser#section-copy-files-to-project), you will be prompted to tag your files as you import them into a project. To tag your files, first copy them from the Data Browser to your project: 1. Navigate to the Data Browser by selecting **Data** from the top navigation bar and clicking on **Data Browser** from the drop-down menu. 2. [Populate the Data Browser with a query](the-data-browser#section-queries-on-the-data-browser). 3. Select the **File** node with the files you wish to copy, and click **+Copy files to project**, as shown below. [block:image] { "images": [ { "image": [ "https://files.readme.io/TIIAQwSy6uuqBjHiwrAA_Screen%20Shot%202016-05-20%20at%2011.14.58%20AM.jpeg", "Screen Shot 2016-05-20 at 11.14.58 AM.jpeg", "2692", "1364", "", "" ] } ] } [/block] A pop-up will appear, indicating which files will be copied. [block:image] { "images": [ { "image": [ "https://files.readme.io/8hUJZrv5SYSRSvXGIMIG_Screen%20Shot%202016-05-09%20at%2012.16.06%20PM.jpeg", "Screen Shot 2016-05-09 at 12.16.06 PM.jpeg", "636", "622", "#326b4b", "" ] } ] } [/block] 4. Click on your desired project from the **Projects** list, as shown above. You can also use the search box to find your project. In the **Copy** dialog which appears, you see how many files will be successfully imported into your project. [block:image] { "images": [ { "image": [ "https://files.readme.io/UDe2x7A9QkWLWBNZYVb8_Screen%20Shot%202016-05-20%20at%2011.56.08%20AM.jpeg", "Screen Shot 2016-05-20 at 11.56.08 AM.jpeg", "860", "602", "#337e53", "" ] } ] } [/block] [block:callout] { "type": "success", "body": "You can check you're importing your files into the right project by clicking on the hyperlinked project name to open your project in a new tab." } [/block] 5. Enter one or more tags, separated by commas or by the return key, into the box below **Tag files**. Any previously used tags in your selected project will be autosuggested. [block:image] { "images": [ { "image": [ "https://files.readme.io/3BfUIhInSIyCg1XRLvjO_Screen%20Shot%202016-05-20%20at%2012.16.35%20PM.jpeg", "Screen Shot 2016-05-20 at 12.16.35 PM.jpeg", "916", "600", "#357953", "" ] } ] } [/block] 6. When you are finished tagging your files, click** Copy selected files**. The files will display in the **Files** tab of your project. Learn more about [file tags within a project](#section-manage-file-tags-in-a-project) below. Since there are two file nodes, **Files** and **Files1**, in the example query above, you can copy the files separately. Now that all the Primary tumor files from **Files** has been copied into the project, you can copy the blood derived normal files from **Files1**, as shown below. [block:image] { "images": [ { "image": [ "https://files.readme.io/kP0rOvcMQ4CL62GIaMMs_Screen%20Shot%202016-05-20%20at%2012.20.31%20PM.jpeg", "Screen Shot 2016-05-20 at 12.20.31 PM.jpeg", "862", "682", "", "" ] } ] } [/block] Note that the previously used tags in the target project will be auto-suggested. <div align="right"><a href="#top">top</a></div> ##Copying files from the Public Reference Files repository When you copy files from the [**Public Reference Files** repository](copy-files-to-a-project), you will be prompted to tag your files as you import them into a project. To tag your files, first copy them from the **Public Reference Files** to your project: 1. Navigate to **Public Reference Files** by selecting **Data** from the top navigation bar and clicking **Public Reference Files** from the drop-down menu. 2. In the file picker which appears, click the checkbox next to your desired files to select them, as shown below. [block:image] { "images": [ { "image": [ "https://files.readme.io/QlMg3UDSlSSVftzol3Qw_Screen%20Shot%202016-05-11%20at%2010.54.07%20AM.jpeg", "Screen Shot 2016-05-11 at 10.54.07 AM.jpeg", "2762", "1292", "#43616f", "" ] } ] } [/block] 3. Click **Copy to Project**, and select your desired project from the drop-down menu. [block:image] { "images": [ { "image": [ "https://files.readme.io/HiKH94QtTzqLYMjsPWxV_Screen%20Shot%202016-05-20%20at%202.32.54%20PM.jpeg", "Screen Shot 2016-05-20 at 2.32.54 PM.jpeg", "922", "480", "#dd7677", "" ] } ] } [/block] 4. In the pop-up which appears, check you're copying the correct number of files into your desired project. 5. Enter one or more tags, separated by commas, into the box. Any previously used tags in your selected project will be autosuggested. 6. Click **OK** to finish importing files into your project. The files will display in the **Files** tab of your project. Learn more about [file tags within a project](#section-manage-file-tags-in-a-project) below. <div align="right"><a href="#top">top</a></div> ##Manage file tags within a project To manage file tags within your project, first [navigate to your project](view-a-project). From the **Files** tab of your project, you can: * [Add or edit tags](link) for your files * [Remove tags](link) from your files * [Filter files](link) via their tags ###Add or edit tags for your files To add tags to files within a project: 1. Click the checkbox next to your desired files to select them, as shown below. [block:image] { "images": [ { "image": [ "https://files.readme.io/veEs2v0OT8K47NTHitmC_Screen%20Shot%202016-05-09%20at%2012.56.12%20PM.jpeg", "Screen Shot 2016-05-09 at 12.56.12 PM.jpeg", "2756", "1026", "#446471", "" ] } ] } [/block] 2. Click **Tags**. 3. In the pop-up box, enter one or more tags separated by commas. Any previously used tags in your selected project will be autosuggested. [block:image] { "images": [ { "image": [ "https://files.readme.io/nAyy1AtxSaifmAJHBhFk_copy%20Screen%20Shot%202016-05-09%20at%2012.38.44%20PM%20(1).jpg", "copy Screen Shot 2016-05-09 at 12.38.44 PM (1).jpg", "2764", "1016", "#4f7dbb", "" ] } ] } [/block] [block:callout] { "type": "info", "body": "When you add tags to files which already have tags, the new tags will have solid background colors in the **Tag files** pop-up. This is to help you distinguish between old and new tags." } [/block] 4. Click **Apply** to finish tagging. You have now added tags to your files. In the example below, the **WXS** tag has been added to all files. The old tags on each file remain attached to the respective files. [block:image] { "images": [ { "image": [ "https://files.readme.io/Je7QmLysRDCuUXbPXhg7_Screen%20Shot%202016-05-09%20at%203.13.22%20PM%20(1).jpeg", "Screen Shot 2016-05-09 at 3.13.22 PM (1).jpeg", "2762", "1010", "#44626a", "" ] } ] } [/block] ###Remove tags from your files To remove tags from files in your project: 1. Click the checkbox next to your desired files to select them, as shown below. [block:image] { "images": [ { "image": [ "https://files.readme.io/e28ZZc2sTOiHcQkqOvtD_Screen%20Shot%202016-05-09%20at%201.00.20%20PM.jpeg", "Screen Shot 2016-05-09 at 1.00.20 PM.jpeg", "2764", "1008", "", "" ] } ] } [/block] 2. Click **Tags**. 3. In the pop-up box, click the **x** next to the tags you want to delete. [block:image] { "images": [ { "image": [ "https://files.readme.io/dr2zdnXCT0CVarSy6uxF_copy%20Screen%20Shot%202016-05-09%20at%201.01.20%20PM%20(1).jpg", "copy Screen Shot 2016-05-09 at 1.01.20 PM (1).jpg", "780", "586", "#f66710", "" ] } ] } [/block] 4. Click **Apply** to finish removing tags. You have now removed tags from your files. In the example below, the VCF tag has been removed from the selected files. [block:image] { "images": [ { "image": [ "https://files.readme.io/BGNgkzffQK22L5QSAcT0_Screen%20Shot%202016-05-09%20at%201.02.00%20PM%20(1).jpeg", "Screen Shot 2016-05-09 at 1.02.00 PM (1).jpeg", "2756", "756", "#446466", "" ] } ] } [/block] <div align="right"><a href="#top">top</a></div> ###Filtering tags within a project You can filter tags within a project from the **File Picker** or the **Files** tab. The process for both is the same. Simply navigate to either the **File Picker** (as shown below) or the **Files** tab to start. To filter tags in the **File Picker**: 1. Access the **File Picker** by navigating to your desired project, selecting the **Files** tab, and clicking **+Add files**. [block:image] { "images": [ { "image": [ "https://files.readme.io/a3QOAR1XSgSiINE4XqTY_Screen%20Shot%202016-05-09%20at%203.32.30%20PM.jpeg", "Screen Shot 2016-05-09 at 3.32.30 PM.jpeg", "2692", "1114", "#c07995", "" ] } ] } [/block] 2. Click on **Tags: All to set your filter(s)**, as shown below. [block:image] { "images": [ { "image": [ "https://files.readme.io/bTbhXyAsRkqcyIzIaIel_Screen%20Shot%202016-05-09%20at%203.32.30%20PM.jpeg", "Screen Shot 2016-05-09 at 3.32.30 PM.jpeg", "2692", "1114", "#c07995", "" ] } ] } [/block] Files matching your filter should display in the **File Picker**. [block:callout] { "type": "info", "body": "You can also filter by clicking a tag listed below the respective file name. For example, clicking known **indels** will filter for all files with the known **indels** tag." } [/block] <div align="right"><a href="#top">top</a></div> ###Copying files between projects When you copy files between projects, you will be prompted to tag your files as you import them into a project. To copy files between projects: 1. Navigate to your desired project by selecting **Projects** from the top navigation bar and clicking **View all** from the drop-down menu. 2. Select the project which contains the files you wish to copy. 3. From the project dashboard, click the **Files** tab. This will display a list of all the files in your project. 4. Click the checkbox next to your desired files to select them, as shown below. [block:image] { "images": [ { "image": [ "https://files.readme.io/LMVqJhB2R1embqyOjkzA_Screen%20Shot%202016-05-09%20at%203.55.45%20PM.jpeg", "Screen Shot 2016-05-09 at 3.55.45 PM.jpeg", "2756", "916", "", "" ] } ] } [/block] 5. Click **Copy to** and select your desired project from the drop-down menu. [block:image] { "images": [ { "image": [ "https://files.readme.io/DRR6rfWAR1u0QckzHFPr_Screen%20Shot%202016-05-09%20at%203.56.23%20PM.jpeg", "Screen Shot 2016-05-09 at 3.56.23 PM.jpeg", "2772", "1030", "#425c64", "" ] } ] } [/block] 6. In the pop-up box, check you're copying the correct number of files into your desired project. 7. Enter one or more tags, separated by commas, into the box. You'll see existing tags for the files, and any previously used tags in your selected project will be autosuggested. [block:image] { "images": [ { "image": [ "https://files.readme.io/OLedYfPnSeKwRChkoVhN_Screen%20Shot%202016-05-09%20at%203.57.25%20PM.jpeg", "Screen Shot 2016-05-09 at 3.57.25 PM.jpeg", "1136", "514", "#bc7d7e", "" ] } ] } [/block] 8. Click **Ok** to finish importing files into your project. The files will display in the **Files** tab of your selected project. <div align="right"><a href="#top">top</a></div>