namespaces

CloudBees platform

A namespace is a logical grouping of feature flags in CloudBees feature management, typically defined through a consistent naming convention using dot-separated prefixes, for example, checkout.enableDiscounts. Namespaces are not a distinct field in the UI but are established by applying structured, prefixed names to feature flags to denote ownership, function, or service area.

Usage:

Namespaces help organize flags within systems that span teams, services, or modules. They prevent naming conflicts, clarify ownership, and enhance maintainability. For example, flag names such as auth.enable2FA and user.profileRedesign contain logical namespaces (auth, user) that reflect specific teams or application features.

In the SDK:

Namespaces are programmatically significant in the CloudBees feature management SDK. They are used to register containers and scope operations such as freezing, unfreezing, and feature flag evaluation at the namespace level.

Tips for using namespaces effectively

Follow these tips to help organize, manage, and scale your use of namespaces:

  • Use dot notation, for example, team.featureName to define namespaces.

  • Align namespace patterns with team structures, service boundaries, or functional domains.

  • Use namespaces to enable modular development, ownership tracking, and namespace-scoped feature control in the SDK.

Related term and documentation

Label – A flexible metadata field used for categorizing and filtering feature flags across namespaces.

Refer to Namespaces and labels for more information.

Back to the CloudBees platform lexicon index