debian-mirror-gitlab/doc/user/search/advanced_search.md

stage	group	info	type
Data Stores	Global Search	To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments	reference

Advanced Search (PREMIUM)

Moved to GitLab Premium in 13.9.

You can use Advanced Search for faster, more efficient search across the entire GitLab instance. Advanced Search is based on Elasticsearch, a purpose-built full-text search engine you can horizontally scale to get results in up to a second in most cases.

You can find code you want to update in all projects at once to save maintenance time and promote innersourcing.

You can use Advanced Search in:

• Projects
• Issues
• Merge requests
• Milestones
• Users
• Epics (in groups only)
• Code
• Comments
• Commits
• Project wikis (not group wikis)

For Advanced Search:

• You can only search files smaller than 1 MB. For self-managed GitLab instances, an administrator can change this limit.

• You can't use any of the following characters in the search query:

  . , : ; / ` ' = ? $ & ^ | ~ < > ( ) { } [ ] @
  

• Only the default branch of a project is indexed for code search. In a non-default branch, basic search is used.

• Search results show only the first match in a file, but there might be more results in that file.

Enable Advanced Search

• On GitLab.com, Advanced Search is enabled for groups with paid subscriptions.
• For self-managed GitLab instances, an administrator must enable Advanced Search.

Syntax

Advanced Search uses Elasticsearch syntax. The syntax supports both exact and fuzzy search queries.

Syntax	Description	Example
"	Exact search	"gem sidekiq"
|	Or	display | banner
+	And	display +banner
-	Exclude	display -banner
*	Partial	bug error 50*
\	Escape	\*md
#	Issue ID	#23456
!	Merge request ID	!23456

Code search

Syntax	Description	Example
filename:	Filename	filename:*spec.rb
path:	Repository location	path:spec/workers/
extension:	File extension without .	extension:js
blob:	Git object ID	blob:998707*

extension: and blob: return exact matches only.

Examples

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.