Asset labels

Labels let you categorize and organize assets in your project. You can assign labels to assets to make them easier to find, filter, and manage.

How labels work#

Labels help teams organize assets and make them easier to browse, filter, and find in the Asset Library and the Asset Selector. Labels can be used to identify assets by subject, campaign, brand, ownership, or other internal organization criteria.

If a project has many labels, they can be grouped so related labels are easier to browse and manage.

Labels can be assigned manually or automatically by AI during upload, helping teams keep assets organized from the start. Each label has a name, color, public ID, and optional description, and can be applied across all assets in a project.

Manage labels#

Labels are configured in the project settings. Users with the appropriate permissions can create, edit, and delete labels.

Asset Labels page in the Settings showing available labels of a project

1. In Uniform, open your project.

2. Navigate to Settings > Asset Labels.

3. Click Add label to create a new label.

4. Enter the following values:

   Field	Description
   Display name	A human-readable name for the label.
   Public ID	A unique identifier (lowercase, numbers, and hyphens, up to 40 characters).
   Color	A swatch color used to visually distinguish the label.
   Description	Optional text describing the label's purpose.

5. Click Save.

Edit or delete a label#

To edit or delete an existing label, select it from the list on the Asset Labels settings page.

Label groups#

Label groups let you organize related labels under a shared parent.

• Groups help structure large sets of labels into logical categories (for example, "Region", "Campaign", or "Brand").
• Groups appear as visual dividers in the label list and as grouped options in label pickers.

To create a label group:

1. On the Asset Labels settings page, click Add label group.
2. Enter a display name, public ID, color, and optional description.
3. Click Save.

After creating a group, you can assign existing labels to the group or create new labels directly within it.

Assign labels to assets#

You can assign labels to an asset from the asset editor in the Asset Library or from the asset detail view inside an asset parameter.

Assign a label to an asset

1. Open the asset you want to label.
2. In the Labels field, select one or more labels from the picker.
3. Click Save.

The label picker displays labels grouped by their label group. You can search for labels by name. Group labels cannot be assigned to assets. Only individual (non-group) labels can be assigned. Each asset supports up to 30 labels.

Assigned labels are also visible on asset cards and table rows in the Asset Library.

AI label assignment at upload#

When you upload an image asset, Uniform's AI can automatically suggest labels based on the image content.

• AI labeling happens during the upload flow when AI asset analysis is enabled.
• The AI evaluates the image against labels defined in the project and suggests matching labels.
• You can review and adjust the suggested labels before saving.
• Label guidance can be configured under Settings > AI Guidance > Assets to influence how the AI assigns labels.

Filter assets by label#

In the Asset Library#

Filtering assets by a label

The Asset Library provides two ways to filter by label. The quick filter is available in the Assets navigation sidebar, where you can select one or more labels to instantly narrow the asset list. For more control, use the advanced filter in the filter bar above the asset list to build label-based conditions with the following operators:

In the Asset Selector#

When selecting assets from a component or entry parameter, the same filtering capabilities are available:

• Quick filter: Filter by label directly in the asset selector.
• Advanced filter: Use label filter operators (is, is any of, is not, is none of, is empty, is not empty) to narrow the selection.

Default labels for asset parameters#

You can configure default labels on an asset parameter so that uploads and selections are pre-filtered.

Set up default labels on an asset parameter#

1. Open the component definition or content type that contains the asset parameter.
2. Edit the asset parameter configuration.
3. In the Default labels section, select one or more labels.
4. Save the component definition or content type.

Configure default labels on an asset parameter

How default labels affect asset selection and uploads#

• Uploads: When a user uploads an asset through a parameter with default labels, those labels are automatically assigned to the uploaded asset.
• Selection: When a user opens the asset selector on a parameter with default labels, the asset list is initially filtered to show assets matching those labels.

Asset label permissions#

Managing labels requires label permissions (Create, Update, and Delete) configured through default permissions or project policies in roles. Read permissions for asset labels are granted by default.

In the built-in role presets, these label permissions are included in the Editor and Developer roles.

For details on configuring these permissions, see roles and permissions and project policies.

CLI commands for labels#

Use the Canvas CLI label commands to back up labels to files and sync them between projects.