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.

🚧

On this page:

• Add tags when copying files
• Copying files from the Data Browser
• Copying files from the Public Reference Files repository
• Manage file tags within a project
• Add or edit tags for your files
• Remove tags from your files
• Filtering tags within a project
• Copying files between projects

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.

4. Click on your desired project.

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

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.

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

3. Click Copy and select your project.

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 Add tags box. Any previously used tags in your selected project will be autosuggested.
6. 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 edit tags for your files
• Remove tags from your files
• Filter files 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.

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.

📘

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.

4. 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. Click the checkbox next to your desired files to select them, as shown below.

2. Click Tags.
3. In the pop-up box, click the x next to the tags you want to delete.

4. Click Apply to finish removing tags.

You have now removed tags from your files. In the example below, the "TEST" tag has been removed from the selected files.

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.

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

6. Click Copy to confirm.

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