Advanced search

Version history

Use advanced search to find exactly what you need across your entire GitLab instance.

With advanced search:

Identify code patterns across all projects to refactor shared components more efficiently.
Locate security vulnerabilities across your entire organization's codebase and dependencies using advanced vulnerability management.
Track usage of deprecated functions or libraries throughout all repositories.
Find discussions buried in issues, merge requests, or comments.
Discover existing solutions instead of reinventing functionality that already exists.

Advanced search works in projects, issues, merge requests, milestones, users, epics, code, comments, commits, and wikis.

Prerequisites:

Advanced search must be enabled:
- For GitLab.com and GitLab Dedicated, advanced search is enabled by default in paid subscriptions.
- For GitLab Self-Managed, an administrator must enable advanced search.

To use advanced search:

You can also use advanced search in a project or group.

Scopes describe the type of data you're searching. The following scopes are available for advanced search:

Scope	Global ¹ ²	Group	Project
Code	{check-circle-filled} Yes	{check-circle-filled} Yes	{check-circle-filled} Yes
Comments	{check-circle-filled} Yes	{check-circle-filled} Yes	{check-circle-filled} Yes
Commits	{check-circle-filled} Yes	{check-circle-filled} Yes	{check-circle-filled} Yes
Epics	{check-circle-filled} Yes	{check-circle-filled} Yes	{dash-circle} No
Issues	{check-circle-filled} Yes	{check-circle-filled} Yes	{check-circle-filled} Yes
Merge requests	{check-circle-filled} Yes	{check-circle-filled} Yes	{check-circle-filled} Yes
Milestones	{check-circle-filled} Yes	{check-circle-filled} Yes	{check-circle-filled} Yes
Projects	{check-circle-filled} Yes	{check-circle-filled} Yes	{dash-circle} No
Users	{check-circle-filled} Yes	{check-circle-filled} Yes	{check-circle-filled} Yes
Wikis	{check-circle-filled} Yes	{check-circle-filled} Yes	{check-circle-filled} Yes

Footnotes:

An administrator can disable global search scopes. On GitLab Self-Managed, global search is not available when limited indexing is enabled by default. An administrator can enable global search for limited indexing.
On GitLab.com, global search is not enabled for code, commits, and wikis.

Advanced search uses simple_query_string, which supports both exact and fuzzy queries.

When you search for a user, the fuzzy query is used by default. You can refine user search with simple_query_string.

Syntax	Description	Example
`filename:`	Filename	`filename:*spec.rb`
`path:`	Repository location (full or partial matches)	`path:spec/workers/`
`extension:`	File extension without `.` (exact matches only)	`extension:js`
`blob:`	Git object ID (exact matches only)	`blob:998707*`

Query	Description
`rails -filename:gemfile.lock`	Returns `rails` in all files except the `gemfile.lock` file.
`RSpec.describe Resolvers -*builder`	Returns `RSpec.describe Resolvers` that does not start with `builder`.
`bug \| (display +banner)`	Returns `bug` or both `display` and `banner`.
`helper -extension:yml -extension:js`	Returns `helper` in all files except files with a `.yml` or `.js` extension.
`helper path:lib/git`	Returns `helper` in all files with a `lib/git*` path (for example, `spec/lib/gitlab`).

You can search only files smaller than 1 MB. For more information, see issue 195764. For GitLab Self-Managed, an administrator can configure the Maximum file size indexed setting.
You can use advanced search only on the default branch of a project. For more information, see issue 229966.
The search query must not contain any of the following characters:
```
. , : ; / ` ' = ? $ & ^ | < > ( ) { } [ ] @
```
For more information, see issue 325234.
Search results show only the first match in a file. For more information, see issue 668.