Skip to main content
Use the migration plugin to migrate from an asset-centric to a data modeling-based Cognite Data Fusion (CDF) project.
The data modeling status of a CDF project controls which asset-centric APIs stay available, and how applications behave, before and after you migrate.
The migration plugin is an experimental feature. Updates to the Cognite Toolkit are likely to introduce changes to the described commands and processes.
Enable the Migration plugin in your cdf.toml file:
cdf.toml

​
Get started

Kelmarsh example

Learn about the Kelmarsh wind farm sample data and how the Cognite Data Fusion (CDF) migration plugin guides use it.

Known limitations

Known limitations in data modeling that do not yet have feature parity with asset-centric CDF projects.

Migration overview

Learn how to use the migration plugin to migrate from asset-centric to data modeling-based CDF projects.

Test with production data

Replicate production data to a development CDF project so you can test migration before running it in production.

​
Prepare

Data model and mappings

Create the data model and mappings prerequisite for migration.

Deploy CogniteMigration

Deploy the CogniteMigration data model to prepare for migration from an asset-centric to a data modeling-based CDF project.

​
Migrate resources

Migrate data sets

Migrate data sets to instance spaces.

Migrate source systems

Use source systems to aid the migration from an asset-centric to a data modeling-based CDF project.

Migrate assets

Migrate assets from an asset-centric to a data modeling-based CDF project.

Migrate events

Migrate events from an asset-centric to a data modeling-based Cognite Data Fusion (CDF) project.

Migrate events to records

Migrate events to records in a data modeling-based Cognite Data Fusion (CDF) project.

Migrate files and time series

Migrate files and time series from an asset-centric to a data modeling-based CDF project.

Migrate annotations

Migrate annotations from an asset-centric to a data modeling-based CDF project.

​
Migrate applications

Migrate Canvas

Migrate asset-centric Canvas configurations to a data modeling-based Canvas.

Migrate Charts

Migrate asset-centric Charts configurations to a data modeling-based Charts.

Migrate InField

Migrate InField application configuration and data to InField based on CDM.

Migrate 3D models

Migrate 3D models from an asset-centric to a data modeling-based CDF project.

Migrate 360 images

Migrate 360 images and 360 image annotations from an asset-centric to a data modeling-based CDF project.

​
Reference

Syncers

Learn how CDF uses syncers to manage CogniteFile and CogniteTimeSeries data model concepts.
For up-to-date information on the available commands, use the cdf migrate --help command.
Last modified on October 15, 2026