Tag your files

Overview

You can tag your files with keywords or strings on BioData Catalyst powered by Seven Bridges 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 directly from your computer, 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. Choose a dataset.
  3. Define a query.
  4. Select the File node with the files you wish to copy, and click +Copy files to project, as shown below.

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

  1. Click on your desired project.

In the Copy dialog which appears, you see how many files will be copied into your project.

  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.

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

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. Select Data from the top navigation bar and click Public Reference Files.
  2. In the file picker which appears, click the checkbox next to your desired files to select them, as shown below.

  1. Click Copy and select your project.

  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 Add tags box. Any previously used tags in your selected project will be autosuggested.
  3. Click Copy to finish copying 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 remove tags from 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.
768
  1. Click Edit 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.
1269

📘

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 TEST tag has been added to all files. The old tags on each file remain attached to the respective files.

Remove tags from your files

To remove tags from files in your project:

  1. Select the file(s).
767
  1. Click Edit tags and choose "Remove tags".
  2. Choose to either remove specific tags or use "Remove all tags" to remove them all.
472
  1. Click Remove to finish removing tags.

Filtering tags within a project

You can filter tags within a project from the Files tab.

  1. Navigate to your desired project and select the Files tab
  2. Click Tags: All to set your filter(s). Files matching your filter are displayed in the list.

📘

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. Open the project that contains the files you wish to copy.
  2. Click the Files tab. This will display a list of all the files in your project.
  3. Select the files you want to copy.
  4. Click Copy and select the destination project.
767
  1. Select "Keep preexisting tags" if you wish to use the tags that are already specified for the file. Alternatively, enter one or more tags, separated by commas, into the box below.
476
  1. Click Copy to confirm.

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