Filtering a code insight

This how-to assumes that you already have created some search insights.

1. Click the filter icon button for the insight you want to filter

While viewing the insight you want to filter, click the filter icon in the upper right corner of the insight. This will open the filter popover.

2. Filter to include or exclude repositories using a regular expression

The filter popover gives you two inputs that allow you to to filter the repositories contributing to the insight, either via inclusion or exlcusion.

Enter a regular expression for repository names that you'd like to include or exclude. Inclusion filters limit your insight to show data from only given repository matches. Exclusion filters filter out results from the repository matches. (More details on how repo filters are applied.)

The regular expression to filter for a repository works the same as the repo: filter in the search box.

Examples:

Pattern	Explanation
^github\.com/sourcegraph/sourcegraph$	Filter the specific repository github.com/sourcegraph/sourcegraph
^github\.com/sourcegraph/(sourcegraph|about|docsite)$	Filter the specific repositories github.com/sourcegraph/sourcegraph, github.com/sourcegraph/about and github.com/sourcegraph/docsite
^github\.com/sourcegraph/go-	Filter all repositories that start with github.com/sourcegraph/go-
service	Filter all repositories that contain the word service in their name
\.js$	Filter all repositories that end in .js

3. Close the filter panel

You can safely click outside the panel to close it and your filters will remain (until a page reload).

A dot next to the filter icon indicates that an insight currently has filters applied.

4. Edit or reset filters

Click the filter button again to edit or reset filters.

5. Save your filters as defaults on this insight (optional)

By default, the filter will only be visible to you locally and will reset after a page reload.

To persist the filter so that anyone who views the insight will have the filters applied by default, click "Save/update default filters".

6. Save as new view (optional)

If you don't want to modify the insight for all future viewers, but still want to preserve your filtered view, you can select "save as new view."

This will fork the insight and create a separate chart on the dashboard with these filters applied by default. The original insight will be unmodified, and future edits to either insight will be independent.