Tag your files

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.

👍

Tag files during upload

Learn more about tagging files as you upload them via the command line, or from an FTP or HTTP(S) server.

Add tags when copying files

Copying files from the Data Browser

When you copy files from the Data Browser, 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.
  3. Select the File node with the files you wish to copy, and click +Copy files to project, as shown below.
2692

A pop-up will appear, indicating which files will be copied.

636
  1. 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.

860

👍

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.

  1. 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.
916
  1. 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 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.

862

Note that the previously used tags in the target project will be auto-suggested.

Copying files from the Public Reference Files repository

When you copy files from the Public Reference Files repository, 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.
2762
  1. Click Copy to Project, and select your desired project from the drop-down menu.
922
  1. In the pop-up which appears, check you're copying the correct number of files into your desired project.
  2. Enter one or more tags, separated by commas, into the box. Any previously used tags in your selected project will be autosuggested.
  3. 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 below.

Manage file tags within a project

To manage file tags within your project, first navigate to your project. From the Files tab of your project, you can:

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.
2756
  1. Click Tags.
  2. In the pop-up box, enter one or more tags separated by commas. Any previously used tags in your selected project will be autosuggested.
2764

📘

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.

  1. 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.

2762

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.
2764
  1. Click Tags.
  2. In the pop-up box, click the x next to the tags you want to delete.
780
  1. 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.

2756

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.
2692
  1. Click on Tags: All to set your filter(s), as shown below.
2692

Files matching your filter should display in the File Picker.

📘

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.

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.
2756
  1. Click Copy to and select your desired project from the drop-down menu.
2772
  1. In the pop-up box, check you're copying the correct number of files into your desired project.
  2. 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.
1136
  1. Click Ok to finish importing files into your project.

The files will display in the Files tab of your selected project.