Labels overview

Organize and categorize your Storytell assets

Written By Mark Ku

Last updated 13 days ago

Labels are customizable tags that help you organize, filter, and manage your assets in Storytell. You can assign one or more labels to any file, choose colors and icons for quick recognition, and use labels to find related content or scope chats to a subset of your knowledge.

Benefits:

  • Organization — Group assets by project, client, content type, or priority without moving files.

  • Discovery — Filter the Files page or search by label to locate specific assets fast.

  • Chat scope — @mention a label in chat to limit the conversation to files that have that label.

  • Flexibility — Apply multiple labels per asset and change them as your workflow evolves.

ℹ️ Labels are essential to creating your Collections. Learn about Collections here: Data Collections: Overview

How labels work

The Labels system is part of your Knowledge experience. You can:

  • Create custom labels with unique colors and icons for your project.

  • Apply labels to individual assets or to many assets at once.

  • See labels in the main asset table and on file cards.

  • Filter and search by label on the Files page and in other views.

Labels are project-scoped: they belong to the project you’re in and are visible to everyone who has access to that project.

Key features

Apply a label to an asset

You can add one or more labels to a single file from the Files page or from file detail view.

To apply a label to one asset:

  1. Go to Files in the sidebar to open the Files page.

  2. Locate the file you want to label (use search or filters if needed).

  3. On the file card, find the Labels area or the three-dot menu (⋮).

  4. Click to add or edit labels — choose Add label or the label selector, then pick one or more labels from the list.

  5. Labels appear on the card immediately. You can manage label visibility and order as needed.

Use cases:

  • Adding context to newly uploaded files

  • Updating categorization as projects evolve

  • Creating cross-project connections between related assets

ℹ️ Good to know: You can apply multiple labels to the same file. Use this to cross-categorize assets (e.g. "Q1" and "Client – Acme") for flexible filtering and chat scope.


Bulk label assets

When you need to tag many files at once, use bulk labeling.

To apply or change labels on multiple assets:

  1. Go to Files in the sidebar.

  2. Select the assets you want to label using the checkboxes on file cards (or your view’s selection control).

  3. In the toolbar or actions menu, click Labels or Edit labels.

  4. Add or remove labels for the selection, then confirm. All selected assets are updated.

Use cases:

  • Organizing newly imported batches of files

  • Updating project or client assignments across many files at once

  • Applying a "Needs review" or "Archive" label in bulk


Filter by label

Use the integrated label filter on the Files page to show only assets that have specific labels.

To filter files by label:

  1. Go to Files in the sidebar.

  2. Find the Filters or Label filter control (often in the header or filter bar).

  3. Click the label filter and select one or more labels. You can also type to search for a label by name.

  4. The file list updates to show only files that have at least one of the selected labels. Clear the filter to see all files again.

Use cases:

  • Finding all assets for a specific project or client

  • Locating files that need review or action

  • Filtering by content type or priority level

Learn more about how to filter labels here: How to filter knowledge using Labels


Use labels in chat

You can put every file with a given label in scope for a chat by @mentioning the label.

To use a label in chat:

  1. In the prompt bar, type @.

  2. In the suggestion list, find Labels or type the label name to search.

  3. Select the label you want. A label pill is added to your prompt.

  4. Send your message. Storytell will use only the files that have that label when answering.

This allows you to ask questions like “Summarize all Q1 reports” or “What do our client docs say about X?” without manually selecting each file.

🚀 Pro-Tip: When writing a prompt, you can use the @ symbol to @mention views, labels, concepts, or assets to put them in the scope of your chat. Give it a try with a label.