Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cognite.com/llms.txt

Use this file to discover all available pages before exploring further.

Alpha flags are experimental features that are in an early testing phase and is likely to change or be removed without prior notice. Do not use the product or functionality in production systems.
The Cognite Toolkit uses alpha flags to enable experimental functionality that we often plan to support in the next minor release. By default, alpha flags aren’t enabled. To enable them, you must update the cdf.toml file. For example, to enable the module-repeat alpha flag, add the following to your cdf.toml file: 
[alpha_flags]
module-repeat = true

​
Cognite Toolkit versioning and releases

The Cognite Toolkit uses semantic versioning to manage versions as major, minor, and patch (for example, 0.3.17).
  • A major version increases with breaking changes in the CLI or the format of modules and configuration files. Installing a new major toolkit version may require updating your configuration files or modules.
  • Minor versions increase with new features and patch versions with bug fixes.
As long as the major version is 0, breaking changes may happen between minor versions. The Cognite Toolkit follows a release cycle of alpha, beta, and stable releases, shown by ‘a’ and ‘b’ in the version number.
  • Alpha releases (for example, 0.3.0a1) test new features, may contain breaking changes, and aren’t recommended for production.
  • Beta releases (0.3.0b1) focus on stability and bug fixes and are suitable for non-production testing.
  • Stable releases (0.3.0) are production-ready.
Introducing new functionality in stable versions can lead to new bugs. Alpha flags allow you to selectively enable new functionality, minimizing the risk of introducing new bugs. The state of alpha flags vary, with some planned for future releases and others being experimental, requiring further testing.

​
Alpha flag: import-cmd

Status: experimental 
[alpha_flags]
import-cmd = true
This flag enables the cdf import command. The only subcommand available is transformation-cli. The command converts the transformation-cli manifest files to the Cognite API (Toolkit) format. Use this, for example, if you have transformations managed by the transformation-cli and want to convert them to the Cognite Toolkit format.

​
Alpha flag: infield

Status: experimental Available from: 0.5.10 
[alpha_flags]
infield = true
This flag enables the infield configuration resource. See cdf.toml for more information about the infield configuration resource.

​
Alpha flag: migrate

Status: experimental Available from: 0.5.45 
[alpha_flags]
migrate = true
This flag enables the cdf migrate command. This command migrates asset-centric resources to data modeling. This is currently an experimental feature and isn’t recommended for production use.

​
Alpha flag: profile

Status: experimental Available from: 0.5.27 
[alpha_flags]
profile = true
This flag enables the cdf profile command. This command allows you to profile CDF resources and their dependencies. Use the cdf profile --help command to see the available options. Note that this command is currently in development and will change in future releases.

​
Alpha flag: create

Status: experimental Available from: 0.7.3 
[alpha_flags]
create = true
This flag enables the create subcommand under the dev plugin, which allows you to create resource YAML files from the CLI. To use this subcommand, you need to enable the dev plugin. Once enabled, you can create resource YAML files with cdf dev create. To get more information about the subcommand, use the --help flag. 
cdf dev create --help

​
Alpha flag: signals

Status: experimental Available from: 0.7.166 This flag enables signal sinks and signal subscriptions in the Cognite Toolkit. When enabled, you can add YAML files under signals/ and deploy them with cdf build and cdf deploy. The YAML Reference Library describes the Sink and Subscription resource types.

​
Alpha flag: data-products

Status: experimental Available from: 0.7.207 
[alpha_flags]
data-products = true
This flag enables data product resources, rule sets, and rule set versions in the Cognite Toolkit. When enabled, you can add rulesets/ YAML files for RuleSet and RuleSetVersion, then build and deploy them with cdf build and cdf deploy.
Last modified on April 20, 2026