Open in the explorer

Enterprise search aggregator settings

Type
Computer and user
GPO path
Computer Configuration › Policies › Administrative Templates › Brave Software › Brave User Configuration › Policies › Administrative Templates › Brave Software › Brave
Supported on
Microsoft Windows 7 or later
ADMX file
brave.admx
Internal name
brave/EnterpriseSearchAggregatorSettings

Explanation

This policy allows administrators to set a designated enterprise search aggregator that will provide search recommendations and results within the omnibox (address bar) and the search box on the New Tab page.

By default, enterprise search suggestions will be blended and shown alongside regular Brave recommendations. Users can explicitly scope their search to just the enterprise search aggregator by typing the keyword specified in the shortcut field with or without the @ prefix (e.g. @work) followed by Space or Tab in the omnibox. Scoped enterprise searches (triggered by a keyword) are currently only supported in the omnibox and not in the search box on the New Tab page.

The following fields are required: name, shortcut, search_url, suggest_url.

The name field corresponds to the search engine name shown to the user in the address bar.

The shortcut field corresponds to the keyword that the user enters to trigger the search. The shortcut can include plain words and characters, but cannot include spaces or start with the @ symbol. Shortcuts must be unique.

The search_url field specifies the URL on which to search. Enter the web address for the search engine's results page, and use '{searchTerms}' in place of the query.

The suggest_url field specifies the URL that provides search suggestions. A POST request will be made and the user's query will be passed in the POST params under key 'query'.

The icon_url field specifies the URL to an image that will be used on the search suggestions. A default icon will be used when this field is not set. It's recommended to use a favicon (example https://www.google.com/favicon.ico). Supported image file formats: JPEG, PNG, and ICO.

The require_shortcut field specifies whether the address bar shortcut is required to see search recommendations. If required, suggestions will not be shown in the search box on the New Tab page, but will continue to be shown in the omnibox (address bar) in scoped search mode. If this field is not set, the address bar shortcut is not required.

On Microsoft® Windows®, this policy is only available on instances that are joined to a Microsoft® Active Directory® domain, joined to Microsoft® Azure® Active Directory® or enrolled in Chrome Enterprise Core.

On macOS, this policy is only available on instances that are managed via MDM, joined to a domain via MCX or enrolled in Chrome Enterprise Core.
See https://chromeenterprise.google/policies/?policy=EnterpriseSearchAggregatorSettings for more information about schema and formatting.

Example value:

{
"name": "My Search Aggregator",
"shortcut": "work",
"search_url": "https://www.aggregator.com/search?q={searchTerms}",
"suggest_url": "https://www.aggregator.com/suggest",
"icon_url": "https://www.google.com/favicon.ico",
"require_shortcut": true
}

Registry

HKEY_LOCAL_MACHINE\Software\Policies\BraveSoftware\Brave
HKEY_CURRENT_USER\Software\Policies\BraveSoftware\Brave
Value name
not defined in the ADMX

Enable / disable values: not defined in the ADMX (see the options below).

PowerShell

PowerShell commands that write to the registry what the policy would write. Values in angle brackets (<…>) must be replaced.

Writing directly to the registry bypasses Group Policy: if a GPO manages this value, it will be rewritten at the next gpupdate; otherwise the value stays in place (the "tattooing" effect). Prefer a GPO or, locally, LGPO.exe. Run PowerShell as administrator for HKLM. Some policies need a restart or gpupdate /force.

Computer (HKLM)

Enable

# Enable: brave/EnterpriseSearchAggregatorSettings
$k = 'HKLM:\Software\Policies\BraveSoftware\Brave'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Enterprise search aggregator settings
Set-ItemProperty -Path $k -Name 'EnterpriseSearchAggregatorSettings' -Value '<value>' -Type String

Disable

# Disable: brave/EnterpriseSearchAggregatorSettings
# No value is written in the "Disabled" state (nothing defined in the ADMX)

Revert to "Not configured"

# Revert to "Not configured": brave/EnterpriseSearchAggregatorSettings
$k = 'HKLM:\Software\Policies\BraveSoftware\Brave'
Remove-ItemProperty -Path $k -Name 'EnterpriseSearchAggregatorSettings' -ErrorAction SilentlyContinue

User (HKCU)

Enable

Disable

Revert to "Not configured"

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Enterprise search aggregator settingsEnterpriseSearchAggregatorSettingsText boxtextEnterpriseSearchAggregatorSettingsREG_SZ
Max length: 1000000

Application

Brave (Brave Software) — November 2026 templates

Official templates downloaded on November 12, 2026.