# Filter

Filters allow you to show and hide elements, connections or loops based on information stored in their [fields](https://docs.kumu.io/guides/fields). This guide will help you master filters, one of the most powerful tools in Kumu!

{% hint style="info" %}
Before you start: [use fields](https://docs.kumu.io/guides/fields) to add additional information to your elements, connections, and loops.
{% endhint %}

## Filter in the Basic Editor

Click the settings icon ![](https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-29572adb5b74c3a9b2db8fca66f2a4a00fe6b652%2Fsliders-h.svg?alt=media) on the right side of the map, then click the icon to the right of **Filter** to open up your filter settings.

![filter](https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-1af62509b5ac902fd158cc0952fa2875cc8e508c%2Foverview-filter.png?alt=media)

If you're filtering by element or connection type, simply un-check the types you want to hide. To filter using other fields, use the "also include" and "but ignore" fields. Click the rocket icon ![](https://1181816445-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkXSW1nEf49ISqGxYuRfS%2Fuploads%2Fgit-blob-789eead0a25caae6c17d918b2940828c7bad678b%2Frocket.svg?alt=media) to the right of the input of each field to select what you want to hide or make visible.

If you've hidden certain elements and connections using the type checkboxes, you can use the **Also include** tool to bring things back into view. But, you first have to un-check some of the boxes above, or this tool will have no effect.

Use the **But ignore** tool to hide elements and connections from your map. Anything you add here will override the settings in the checkboxes above and the **Also include** tool.

## Filter in the Advanced Editor

If you prefer working in the Advanced Editor, you can use the `include` and `ignore` properties in the `@settings` block to activate filters. Here's the basic syntax:

```scss
@settings {
    include: selector;
    ignore: selector;
}
```

You can replace `selector` with any valid [selector](https://docs.kumu.io/guides/selectors). For example, here is the code for a view that includes elements with the element type "Person" but ignores all elements who have no Tags in their profile:

```scss
@settings {
    include: person;
    ignore: element[!"tags"];
}
```

If you want to include or ignore multiple different selections, you can separate selectors with a comma. Here's the code for a view that includes three different selections:

1. All connections
2. All elements with the element type "Organization"
3. All people with the tag "Board of Directors"

```scss
@settings {
    include: connection, organization, element["tags"*="Board of Directors"];
}
```

#### Ignore orphans

You can also use the `ignore-orphans` property in the `@settings` block to automatically filter out any elements that have no connections. Possible values for this property are `true` or `false`.

```scss
@settings {
    ignore-orphans: true;
}
```

## Activate filter using controls

If you'd like to make it easy for readers to activate filter on their own with predefined options, check out the [filter](https://docs.kumu.io/guides/controls/filter-control)[ control](https://docs.kumu.io/guides/controls/filter-control).