Documentation

​
​

Development

User Acquisition

Monetization

Industry

Unity Cloud

Get Started

Asset Manager SDKs and services

Open Unity Dashboard

Unity Cloud

​
​
Unity Dashboard
  • Accounts
  • Organizations
  • Projects
  • Products
  • Billing
Developer Data
  • Introduction to the Developer Data Framework
  • Get started
  • View Diagnostics for your project
  • Privacy and consent
Unity Asset Manager
  • What's new
  • Asset Manager web
    • Get started
    • Manage access and permissions
    • Create projects and collections
    • Add assets
    • Manage assets
      • Asset versioning
      • Asset Dependencies
      • Asset action menu
      • Dependency viewer
      • Edit an asset
      • Bulk edit assets
      • Review workflow
      • Manage custom asset metadata
        • Asset metadata types
        • Create metadata field definitions
        • Add custom metadata field
        • Update custom metadata field
    • Collaboration
    • Discover assets
    • Transform assets
    • Download assets
    • Trash
  • Asset Store
  • Manage Assets in the Editor
  • Unity Version Control
  • Developer documentation
Unity Pipeline Automation
  • About
  • Get started
  • Pipelines
  • Automations
  • Monitor jobs
  1. Unity Cloud Documentation
  2. Asset Manager

Manage custom metadata for assets

How to create and add custom metadata to your assets for enhanced categorization and discovery.
Read time 1 minute
Last updated a year ago

You can add custom metadata fields to your asset when you create or edit an asset version. This metadata can be used for filtering assets or for any pipeline integration use cases. You can view them in the side panel while inspecting an asset. Metadata fields help with better categorization, provide filtering options, and help users to add values.
There are three types of metadata:
  • Primary metadata is the default metadata present with assets that you can update.
  • Custom metadata is the one you create.
  • Extracted metadata and System metadata are generated by our system from built-in pipelines or features. These are read-only.
Note
Any Contributor or higher role can add metadata fields from your Organization library.
Note
A Viewer role in a project can’t see custom metadata fields or the extracted ones.

Organization metadata field library

To drive consistency across your content, your organization has a library of metadata field definition that can be added on your assets.
Only the Asset Manager Admin, Owner, and Manager in your Organization can create new metadata field definitions.
Each metadata field consists of the below:
  • The backend name, which serves as an unique identifier.
  • The display name.
  • The type. Read more about types of metadata fields.
  • The list of accepted values for the selection type.
All metadata field definitions are shared across all assets, so updating the accepted values or display name of one metadata field definition, updates all assets that use it.
Create a metadata field definition in your organization library
Allow contributors to your projects to add metadata fields to assets
Add a custom metadata field from your organization library
Types of metadata fields

Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page
    • Organization metadata field library


Report a problem with this page