We're looking for a person or people to help audit MDN to find places we could speed up. Is this you or someone you know? Check out the RFP: https://mzl.la/2IHcMiE



Set the default suggestion to appear in the address bar drop-down list when the user starts interacting with your extension.

Once the user has entered your keyword and started interacting with your extension, the default suggestion will always appear first in the drop-down list. Unlike the suggestions you supply in omnibox.onInputChanged, this item can't be selected. Use it to provide the user with some guidance about what to type and what they can expect to see when they do.


  suggestion            // object


object. An object containing a single string property description, which will be displayed as the first item in the drop-down when the user starts interacting with your extension.

Return value


Browser compatibility

ChromeEdgeFirefoxFirefox for AndroidOpera
Basic support Yes No521 No Yes

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


  description: "Type the name of a CSS property"

Example extensions


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: andrewtruongmoz, wbamberg
 Last updated by: andrewtruongmoz,