Organize Dimensions with Namespaces

Namespaces make your Dimension definitions modular and easier to manage. Instead of one large definitions file, you can separate definitions by team, project, or any other grouping that fits your workflow. Each namespace has its own version history, and publishing, downloading, and restoring definitions all apply to one namespace at a time, so teams can work independently without affecting each other.

Every organization starts with a default namespace called User:Defined. All namespace names use the User: prefix (for example, User:Finance, User:Platform). You can keep all your definitions in the default namespace or create additional ones as your organization grows.

What you need

A CloudZero account with the Modify Dimension Definitions permission

Create a namespace

Go to Settings > Namespaces.
Select + Create Namespace.
Enter a name for the namespace (for example, Finance, Platform, or TeamAlpha). The User: prefix is required and is prepended automatically if you do not include it.
Select Create Namespace. The namespace appears in the list and is ready for use.

To create namespaces from VS Code, see Create a new namespace in the VS Code Extension guide. In Dimension Studio, you can select which namespace to publish to when creating or editing Dimensions.

⚠️
Dimensions in the Default namespace (User:Defined) can be referenced by rules in any namespace, making it the right place for shared Dimensions. Dimensions in custom namespaces can only be referenced by rules within that same namespace. Moving a shared Dimension out of the Default namespace breaks any rules in other namespaces that reference it.

Delete a namespace

⚠️
Deleting a namespace permanently removes all Dimension definitions and version history it contains. This action cannot be undone. The Default namespace (User:Defined) cannot be deleted.

Go to Settings > Namespaces.
Click the Delete action next to the namespace you want to remove.
Type the namespace name in the confirmation window and select Delete Namespace.

To delete namespaces from VS Code, see Delete a namespace in the VS Code Extension guide.

Where namespaces appear

Dimension drop-downs in CloudZero (Explorer, Views, Filters) group Dimensions into categories: Organization Dimensions, Cloud Provider Dimensions, Tags, Kubernetes Dimensions, and Kubernetes Labels.

When you create a namespace, it appears as a new group in these drop-downs alongside the defaults. For example, a User:Finance namespace adds a Finance group containing all the Dimensions defined in that namespace.

ℹ️
When you create the first Dimension in a new namespace, it takes a few minutes to appear under its own group. Until processing completes, it shows under your organization's Organization Dimensions group.

Manage namespace permissions

To control which users and roles can view or edit Dimension definitions within a namespace, see Namespace Access Control.

ℹ️
Have questions or feedback? Reach out to your account manager.