---
agentTools:
  projectIndex: https://docs.cancergenomicscloud.org/llms.txt
---

# 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](upload-via-the-command-line), or from an [FTP or HTTP(S) server](upload-from-an-ftp-server).

## 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. **Copy files to project**.
4. Choose the target project for copying files.
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/0cf3c6a-tag-files-data-browser.png",
        "Screen Shot 2016-05-20 at 12.16.35 PM.jpeg",
        "916"
      ],
      "align": "center"
    }
  ]
}
[/block]

6. When you are finished tagging your files, click **Copy selected files**.

<br />

## 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. Select the files.
3. Click **Copy**, and select the target project.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/1b1352e-copy-from-ref-files.png",
        "Screen Shot 2016-05-20 at 2.32.54 PM.jpeg",
        "922"
      ],
      "align": "center"
    }
  ]
}
[/block]

<br />

4. Enter one or more tags, separated by commas, into the box. Any previously used tags in your selected project will be autosuggested.
5. Click **Copy** 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.

## 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. Select a file.
2. Click **Edit tags** and choose "Add tags".

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/000f91a-add-tag.png",
        "Screen Shot 2016-05-09 at 12.56.12 PM.jpeg",
        "2756"
      ],
      "align": "center"
    }
  ]
}
[/block]

<br />

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.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/4389c05-add-new-tags.png",
        "copy Screen Shot 2016-05-09 at 12.38.44 PM (1).jpg",
        "2764"
      ],
      "align": "center"
    }
  ]
}
[/block]

4. Click **Add** to finish tagging.

### Remove tags from your files

To remove tags from files in your project:

1. Select a file.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/765d078-remove-tags.png",
        "Screen Shot 2016-05-09 at 12.56.12 PM.jpeg",
        "2756"
      ],
      "align": "center"
    }
  ]
}
[/block]

2. Click **Edit tags** and choose "Remove tags"
3. Choose to either remove specific tags or use "Remove all tags" to remove them all.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/7fda67a-remove-tags-2.png",
        "copy Screen Shot 2016-05-09 at 1.01.20 PM (1).jpg",
        "780"
      ],
      "align": "center"
    }
  ]
}
[/block]

4. Click **Remove** to finish removing tags.

### Filtering tags within a project

To filter tags:

1. Access your project.
2. Click the **Files** tab.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/7df6d73-tags-in-the-project.png",
        "Screen Shot 2016-05-09 at 3.32.30 PM.jpeg",
        "2692"
      ],
      "align": "center"
    }
  ]
}
[/block]

2. Click **Tags**.
3. Select a tag or multipl you want to use as a filter.
4. Click **Apply**.

### 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. Access your project.
2. Click the **Files** tab.
3. Select files you want to copy.
4. Click **Copy** and select the target project.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/c9ab689-when-copying-files-to-other-project.png",
        "",
        ""
      ],
      "align": "center"
    }
  ]
}
[/block]

6. Under "Tags" enter one or more tags, separated by commas (note: the "Keep pre-existing tags" option is selected by default).
7. Click **Copy** to finish importing files into your project.