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

# Configure location filters

> Configure location filters using the CDF interface or Cognite Toolkit to help users find and select data related to specific physical locations in your CDF project. How you set up the location filters depends on how your data is stored and structured in the CDF project.

<Note>
  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.
</Note>

## Before you start

* Use the `locationfilters` access capability to manage access to configure and view location filters. Follow the instructions in [Assign capabilities](/cdf/access/guides/capabilities) to provide access to the underlying data.

* To see 3D content for a location, [set up scenes](/cdf/3d/guides/scene) 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

<Info title="Early adopter">
  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](https://hub.cognite.com/groups/manage-location-filters-early-adopter-387) on the [Cognite Hub](https://hub.cognite.com).
</Info>

<Steps>
  <Step title="Navigate to location settings">
    Navigate to the <span class="ui-element">Admin</span> workspace > <span class="ui-element">Project settings</span> > <span class="ui-element">Locations</span> > <span class="ui-element">Manage locations</span>.
  </Step>

  <Step title="Create new location">
    Select <span class="ui-element">Add</span> and enter a descriptive location name.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Configure resource type filters">
    Under <span class="ui-element">Filter on resource types</span>, select <span class="ui-element">Resources</span> if the data is modeled with resource types in an asset-centric data model. Otherwise, select <span class="ui-element">Data models</span>.

    * <span class="ui-element">Resources</span>: specify data sets, asset sub-trees, or external ID prefixes for asset-centric resources, such as assets, events, files, time series, and sequences.

          <Info>
            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.
          </Info>

    * <span class="ui-element">Data models</span>: specify data models, data model versions, and data model spaces.

    * <span class="ui-element">Instance spaces</span>: specify instance spaces.
  </Step>

  <Step title="Save and test">
    Save the settings and test the location filters from the CDF home page.
  </Step>
</Steps>

## Set up filters with the Cognite Toolkit

See the [Cognite Toolkit](/cdf/deploy/cdf_toolkit/references/resource_library#locations) articles for information about configuring, deploying, and managing location filters as part of a CI/CD pipeline.