Skip to main content

Crawl restrictions

Control which GitHub content Glean crawls using repository inclusion and exclusion lists and content-type toggles. Use these rules minimally to preserve the search experience: most end users expect to find all content, and most customers apply no rules or use exclusions sparingly for sensitive repositories.

  • Use Greenlist restrictions to allow crawling only for content that you specify.
  • Use Redlist restrictions to prevent Glean from crawling content that you specify.
Restriction TypeGreenlistRedlistDetails
Time-based RestrictionsRestrict crawling to include/exclude content created/modified/viewed after a certain date.
Identity-based RestrictionsRestrict crawling to include/exclude content created/modified/viewed by specific users or a specific group (plus public content).
Content-based RestrictionsRestrict crawling to include/exclude specific content, documents, messages, or objects.

Supported restrictions

RestrictionGreenlistRedlistDetails
RepositoryRestrict crawling to include or exclude specific repositories by name.
GitHub Pages repositoryRestrict GitHub Pages crawling to include or exclude specific repositories by name.

How repository lists work

  • Inclusion (greenlist): Enter specific repository names and Glean crawls only those repositories. Any repository not listed is skipped.
  • Exclusion (redlist): Enter specific repository names and Glean skips those repositories. All other repositories are crawled.

If both rules apply to the same repository, the content is not indexed: the exclusion rule takes priority.

Glean indexes only the repositories granted to the GitHub App installation. If you installed the app on a subset of repositories, only those repositories are eligible for crawling. Repository inclusion and exclusion lists further refine what gets indexed within that granted set.

Content-type controls

In addition to repository-level restrictions, you can toggle crawling for the following content types from the Manage Data tab in the admin console:

Content typeDefaultDescription
GitHub PagesOffCrawl HTML and Markdown files from repositories that use the legacy gh-pages branch. If you do not add repository names, Glean crawls legacy Pages for all repositories by default.
WikisOffCrawl wiki pages attached to repositories.
IssuesOnCrawl issues and issue comments.
Pull request diffsOnCrawl diff content from pull requests.
Code file extensionsVariesControl which code file extensions have their full file body indexed. Existing connectors may show a different set of configured extensions. Admins can update this list as needed.

Apply restrictions

MethodSupportedDetails
Admin UIRestrictions can be applied in the Admin UI under the connector settings.
Glean SupportRestrictions can be applied by Glean support on request.

Navigate to Admin console → Connectors → GitHub and select the Manage Data tab to configure repository lists and content-type toggles.