Version: Unity 6.1 (6000.1)
Language : English
Focus searches with search providers
Activate and deactivate search providers

Use search providers

All searches use at least one search provider:

  • The default providers are Project, Hierarchy, Menu, and Settings. If you run a search without specifying a provider, Search uses these default providers.

  • Alternatively, you can focus the search to one provider. This can be one of the default search providers, or any other search provider available in your project.

    For example, if you need to add assets to your project, you can focus your search to the Asset StoreA growing library of free and commercial assets created by Unity and members of the community. Offers a wide variety of assets, from textures, models and animations to whole project examples, tutorials and Editor extensions. More info
    See in Glossary
    search provider. This focus excludes the project’s current assets from your search results.

Tip: You can have multiple Search windows open, each with different providers active. This makes it easier to perform queries, because you don’t need to explicitly specify your provider in each query. For example, you can have a Search window that uses just the Calculator search provider, so you don’t have to prefix your queries with =.

The Search windows More menu with the list of search providers available in the project
The Search window’s More menu with the list of search providers available in the project

For information about individual search providers, refer to Search provider references.

The purpose of search providers

Use search providers to narrow your search results to a certain type of item. Providers have filters that match the item type they search for, so selecting a provider also narrows your filter list to only the relevant ones.

You can divide the search providers by their purpose:

Purpose Examples
Search your project’s assets Project, Hierarchy, Asset Database.
Search files and presets Files, Presets.
Search external sources Asset Store, the Packages Registry.
Search performance and debugging ProfilerA window that helps you to optimize your game. It shows how much time is spent in the various areas of your game. For example, it can report the percentage of time spent rendering, animating, or in your game logic. More info
See in Glossary
Markers, Performance Trackers, Logs.
Search the Unity Editor interface and actions Settings, Menus, Static API, Calculator.

Some search providers fit into more than one set. For example,:

  • The Packages search provider can fetch items from the Package Manager registry, but it also searches your project for installed packages.
  • The Menus search provider focuses on the Unity Editor’s menus, but it presents its results as actions that you can execute with a double-click.
  • You can include the Files search provider in other search providers.

Custom search providers

You can create your own search providers. For more information, refer to Create a custom search provider.

Search with all active providers at once

By default, a search includes results from four providers:

  • Project: Searches the project’s assets.
  • Hierarchy: Searches GameObjectsThe fundamental object in Unity scenes, which can represent characters, props, scenery, cameras, waypoints, and more. A GameObject’s functionality is defined by the Components attached to it. More info
    See in Glossary
    in the loaded scenesA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
    See in Glossary
    (a loaded scene is displayed in the Hierarchy window).
  • Menu: Search the Unity Editor main menu.
  • Settings: Search all Unity Editor settings.

You can add and remove providers from the default search by toggling them on and off. For more information, refer to Activate and deactivate search providers

Search a single provider

You can limit your search to a single provider for faster queries and a shorter results list.

You can add and remove providers from this search by toggling them on and off. For more information, refer to Activate and deactivate search providers

Use a provider filter in visual queries

When you use the visual query builder, the first filter’s dropdown includes all available search providers.

Note: The search provider selection must be the first filter; you can’t use it anywhere else in the query.

If you select a search provider, all other filters in the query match that provider. For example, if you select the Menus search provider, the next filter dropdown doesn’t include filters for Profiler MarkersPlaced in code to describe a CPU or GPU event that is then displayed in the Unity Profiler window. Added to Unity code by default, or you can use ProfilerMarker API to add your own custom markers. More info
See in Glossary
or Logs.

For more information, refer to Visual query builder.

Use a provider token in a textual query

To use a search provider in a textual query, prefix the query with the provider’s search token.

Note: The search provider’s token must be the first token; you can’t use it anywhere else in the query.

For example, m: is the search token for the Menus search provider. When you enter m:light in the search field, search returns all menu items that contain the word light.

For more information, refer to Textual query references.

Additional sources

Focus searches with search providers
Activate and deactivate search providers