The omnibox.SuggestResult type defines a single suggestion that the WebExtension can add to the address bar's drop-down list.

The WebExtension's omnibox.onInputChanged event listener is passed a callback. To populate the address bar's drop-down list in response to the user's input, the WebExtension can pass an array of omnibox.SuggestResult objects into this callback.


Values of this type are objects. They have the following properties:

This is the value that will appear in the address bar itself when the user highlights this suggestion in the drop-down list. This is also the string sent to the omnibox.onInputEntered event listener if the user selects this suggestion.
This is the string that's displayed in the address bar's drop-down list.

Browser compatibility

Chrome Edge Firefox Firefox for Android Opera
Basic support Yes No 52.0 No Yes

Compatibility notes


  • 'description' is interpreted as plain text, and XML markup is not recognised.


This API is based on Chromium's chrome.omnibox API.

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

Document Tags and Contributors

 Contributors to this page: wbamberg
 Last updated by: wbamberg,