Enrich packages with custom metadata

Custom key-value metadata can now be attached to any package in Cloudsmith, giving structured contextual data - CI build info, Git provenance, commit SHAs, internal attribution - a proper home alongside the artifact it describes. Stored as arbitrary JSON key-value pairs, it's purpose-built for the kind of contextual data that doesn't belong in tags.

Custom metadata displayed on a package in the Cloudsmith web app.

How it works

Custom metadata can be added, updated, deleted, viewed, and searched via the Cloudsmith API and CLI. Once attached, metadata can be used in policy-as-code matching logic and the Cloudsmith package search filter, making it possible to enforce governance and find packages based on the contextual data you've stored.

AddUpdateDeleteViewPackage search filter
API
CLI
Web app
Currently supported custom metadata functionality for the Cloudsmith API, CLI, and web app. Metadata can only be created, updated, and deleted via the API or CLI - the web app supports viewing and searching existing metadata only.

Package search

The Cloudsmith package search now supports a metadata filter.

For more information about using the package search, see Package search syntax.

Getting started

Custom metadata is currently available in early access for Ultra and Enterprise customers. If you have any questions or feedback on this feature, please contact us.

Learn more about custom metadata in our documentation.


Keep up to date with our monthly product bulletin