Global Search

Nova not only allows you to search within specific resources and relationships, you may also globally search across all your resources using the global search input located within the top-navigation bar of the Nova administration panel:

​

Title / Subtitle Attributes

When a resource is shown within the search results, the results will display the “title” of the resource. For example, a User resource may specify the name attribute as its title. Then, when the resource is shown within the global search results, that attribute will be displayed.

To customize the “title” attribute of a resource, you may define a title property or title method on the resource class:

​

Subtitles

You may also display a smaller “subtitle” attribute within the global search results. The subtitle will be placed directly under the title attribute. In this screenshot, you can see that the Post resource’s author is displayed as a subtitle, allowing quick identification of who wrote a given post:

To define a resource’s subtitle, you should override the subtitle method of the resource:

/**
 * Get the search result subtitle for the resource.
 *
 * @return string
 */
public function subtitle()
{
    return "Author: {$this->user->name}";
}

​

Customization

​

Limiting Global Search Results

You can limit the number of results that are returned via global search for a given resource by overriding the globalSearchResults property on the resource:

/**
 * The maximum number of results to include when searching globally.
 *
 * @var int
 */
public static $globalSearchResults = 5;

​

Global Search Debounce

You can configure the debounce timing of the global search field using the Nova::globalSearchDebounce method. Normally, this method should be called from within your application’s NovaServiceProvider:

/**
 * Boot any application services.
 */
public function boot(): void 
{
    parent::boot();
    
    Nova::globalSearchDebounce(1); // 1 second
}

​

Custom Avatars / Covers

If you are building a custom field that you would like to serve as the “avatar image” / cover art for global search results, your field should implement the Laravel\Nova\Contracts\Cover interface. This interface requires you to define a resolveThumbnailUrl method, which should return the URL of your desired “cover art”:

namespace App\Nova;

class Team extends Resource 
{
    /**
     * Resolve the thumbnail URL for the field.
     *
     * @return string|null
     */
    public function resolveThumbnailUrl()
    {
        return 'https://www.example.com/avatar/'.md5(strtolower($this->value)).'?s=300';
    }
}

​

Disabling Global Search for a Resource

By default, all Nova resources are globally searchable; however, you may exclude a given resource from the global search by overriding the globallySearchable property on the resource:

/**
 * Indicates if the resource should be globally searchable.
 *
 * @var bool
 */
public static $globallySearchable = false;

​

Disabling Global Search Globally

If you wish to completely disable global search inside of Nova, you can call the withoutGlobalSearch method from your App/Providers/NovaServiceProvider:

/**
 * Boot any application services.
 */
public function boot(): void
{
    parent::boot();

    Nova::withoutGlobalSearch();
}