Skip to main content
If you’re creating a hierarchy of parent-child locations, all the locations within the hierarchy must be part of the same asset sub-tree.

Before you start

  • Use the locationfilters access capability to manage access to configure and view location filters. Follow the instructions in Assign capabilities to provide access to the underlying data.
  • To see 3D content for a location, set up scenes for the 3D content. When you filter on a location, the 3D scene displays in the 3D view.

Set up filters with the CDF interface

The features described in this section are currently only available to customers via our Early Adopter groups. For more information and to sign up, visit the Manage location filters group on the Cognite Hub.
1

Navigate to location settings

Navigate to the Admin workspace > Project settings > Locations > Manage locations.
2

Create new location

Select Add and enter a descriptive location name.
3

Configure hierarchy and 3D scene

Select a parent if you’re creating a hierarchy of parent-child locations. If you define multiple locations, CDF uses an OR operator between them.Link the location to the 3D scene you want to display in the 3D view for the location.
4

Configure resource type filters

Under Filter on resource types, select Resources if the data is modeled with resource types in an asset-centric data model. Otherwise, select Data models.
  • Resources: specify data sets, asset sub-trees, or external ID prefixes for asset-centric resources, such as assets, events, files, time series, and sequences.
    Be careful if you’re specifying both asset sub-trees or data sets. CDF uses an AND operator between these, which may cause unexpected behavior.
  • Data models: specify data models, data model versions, and data model spaces.
  • Instance spaces: specify instance spaces.
5

Save and test

Save the settings and test the location filters from the CDF home page.

Set up filters with the Cognite Toolkit

See the Cognite Toolkit articles for information about configuring, deploying, and managing location filters as part of a CI/CD pipeline.