> ## 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.

> ## Agent Instructions
> Cognite Data Fusion (CDF) is an industrial DataOps platform. Prefer English docs unless the user asks for another locale.
> Follow /_llms/ index links recursively until you reach page URLs ending in .md. Fetch those Markdown twins instead of HTML.
> For REST APIs, default to calendar version 20230101 (stable). Use 20230101-beta or 20230101-alpha only if the user is on a preview API. Cite paths under /api-reference/concepts/<version>/ and the Cdf-Version header. Prefer the Python SDK (cognite-sdk) unless the user is in JavaScript/TypeScript.
> Start here by task: platform overview /cdf/index.md; data modeling /cdf/dm/index.md; data integration /cdf/integration/index.md; access /cdf/access/index.md; CDF Toolkit /cdf/deploy/cdf_toolkit/index.md; REST quickstart /dev/quickstart.md; Python SDK https://cognite-sdk-python.readthedocs-hosted.com/en/stable/; Atlas AI /cdf/atlas_ai/concepts/index.md; Flows apps /cdf/flows/index.md; MCP and IDE setup /dev/guides/ide_ai_integration.md.
> For implementation work, also load /skill.md.

# Data modeling status for CDF projects

> Learn about the DATA_MODELING_ONLY and HYBRID project statuses and how they affect capabilities and application behavior in Cognite Data Fusion (CDF).

Every Cognite Data Fusion (CDF) project has a data modeling status, stored as `dataModelingStatus`. The status controls whether the project can use asset-centric APIs, and how applications store and show data. The data modeling status applies to all users in the project. To change the data modeling status for a CDF project, contact your Cognite representative.

* `DATA_MODELING_ONLY` is the default status. Use it for new projects and after you upgrade a project to data modeling. Asset-centric write APIs for assets, annotations, and relationships are blocked, and applications use data modeling concepts such as spaces and instances.
* `HYBRID` is only for legacy projects. It keeps asset-centric APIs and workflows available while you [upgrade to data modeling](/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin).

## Understanding each status

The status changes what you can configure, and what each application shows.

| Application or service | DATA\_MODELING\_ONLY | HYBRID |
| - | - | - |
| [Group capabilities](/cdf/access/guides/capabilities) | You can't add `assets:write`, `annotations:write`, `annotations:review`, `annotations:suggest`, or `relationships:write` to a group. CDF blocks write operations on the asset-centric assets, annotations, and relationships APIs. | You can use all capability sets. |
| [InField](/cdf/infield/guides/config_idm) | InField opens the data modeling version of the application. | InField opens the asset-centric version of the application. |
| Charts | Scheduled calculations create a [CogniteTimeSeries](/cdf/dm/dm_reference/dm_core_data_model#timeseries) in a space. Charts hides events. | Scheduled calculations create a time series in a data set. Charts shows events. |
| Canvas | Dropping a file on a canvas creates an instance in a space you choose. You can only find and add data modeling resources. | Dropping a file on a canvas creates a file in a data set you choose. You can find and add both asset-centric and data modeling resources. |
| Search | You can find only data modeling resources. | You can find both asset-centric and data modeling resources. Location filters can limit a location to asset-centric resources, data modeling resources, or both. |
| [3D](/cdf/3d/guides/3dmodels_intro#3d-models-and-project-types) | 3D data uses the [core data model](/cdf/dm/dm_reference/dm_core_data_model). You can contextualize only core data model assets. Automatic text detection in 360° images is available. | You can contextualize CAD models to asset-centric assets and to core data model assets. Contextualization for 360° images and point clouds is not available. Automatic tag detection in 360° images is not available. |
| [Diagram parsing](/cdf/integration/guides/contextualization/diagram_parsing) | Diagram parsing stores annotations as [`CogniteDiagramAnnotation`](/cdf/dm/dm_reference/dm_core_data_model#cognitediagramannotation). Tag detection is generally available. Symbol detection is in [public preview](/cdf/product_feature_status#public-preview). | Diagram parsing stores annotations with the [Annotations API](/api-reference/concepts/20230101/annotations). |
| [Entity matching](/api-reference/concepts/20230101/entity-matching) | CDF doesn't provide a user interface. The API works with data modeling. | CDF provides a user interface. |
| Data catalog | The API works with data modeling. | CDF provides a user interface. |

<Note>
  To preview `DATA_MODELING_ONLY` behavior for 3D in a `HYBRID` project, turn on the read-only override described in [Verify migrated 360° images](/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin/360_images#verifying-migrated-360-images-and-annotations-in-the-ui). Treat the 3D user interface as read-only while the override is on. Leave the override off when you finish.
</Note>

## Why only some APIs and experiences are restricted

`DATA_MODELING_ONLY` restricts only some asset-centric APIs and application experiences. The restriction safeguards the user experience against unintended issues caused by remaining data dependencies. Cognite will resolve those dependencies gradually and tighten the restrictions as each dependency is removed.

Write access is blocked today for assets, annotations, and relationships. In data modeling, assets map to types in the [core data model](/cdf/dm/dm_reference/dm_core_data_model), diagram parsing annotations map to [`CogniteDiagramAnnotation`](/cdf/dm/dm_reference/dm_core_data_model#cognitediagramannotation), and relationships map to [direct relations and edges](/cdf/dm/dm_concepts/dm_spaces_instances#direct-relations-vs-edges).

Events, sequences, files, and time series stay available. In a `DATA_MODELING_ONLY` project, files and time series reference instances instead of assets.

## Related pages

* The [migration plugin](/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin) upgrades an asset-centric project to data modeling.
* [Configure InField on CDM](/cdf/infield/guides/config_idm) sets up InField for a data modeling project.
* The [3D contextualization APIs](/dev/3d/api_dmonly/3d_contextualization_apis) cover contextualization in a data modeling project.
* [Assign capabilities](/cdf/access/guides/capabilities) lists the capabilities you can add to a group.
