Is there a way I can add a custom search URL to the Firefox search bar? e.g. I'd like to provide a URL such as http://blahblah.com?search=%s, where Firefox replaces the %s with the content of the search box.

Both IE and Opera can do this, but I can't figure out how to set it up in Firefox.


12 Answers 12


Add keywords to the address bar:

For example, you can set up your browser to search for bread at stackoverflow.com by simply typing so bread into the omnibar.

Do this by right-clicking on the search bar on the website you commonly search. You can do this for the Search field on any website.

Right click on the search bar


  1. Go to the site you want to use to search
  2. Right-Click on the search box you fill out on their page (not Firefox's)
  3. Select "Add a keyword"
  4. Enter the keyword to use when you want to search in that site (eg: "so")
  • 9
    I had no idea that existed... just added 'su' for this site! works great, good tip!
    – codeLes
    Jul 17 '09 at 19:40
  • 7
    @Jed Daniels Chrome does have it in the form of custom search engines - Options -> Manage Search Engines
    – Dan H
    Jul 3 '11 at 7:12
  • 7
    Is there more updated info on this maybe? Just downloaded latest Firefox on macOS and this doesn't work. :-(
    – user24601
    Mar 16 '18 at 13:39
  • 4
    This is not working now Mar 31 '18 at 19:27
  • 5
    Of course, this only works if there is a search-box available to click on, and worse, it doesn't let you customize the actual query. I can't believe Firefox still doesn't let you natively add customize search engines which Chrome has let you do since it first came out. :-|
    – Synetech
    Mar 1 '20 at 1:10

I'd like to provide a URL such as http://blahblah.com?search=%s where Firefox replaces the %s with the content of the search box.

You can do this with Firefox! Add a bookmark with that URL, where %s is the search query, then simply set a keyword for the bookmark. You can then search using <key> <search term> in the address bar. For example, the bookmark http://www.google.com/search?q=%s with keyword g means you can type g stack overflow in the address bar to search Google for "stack overflow".

Alternatively, go to the site you want to search, right click in the search box and click "Add a keyword for this search".

  • 7
    And what if I don't want a bookmark? What if I only want a search engine without bookmarking it?
    – Synetech
    Jul 13 '17 at 18:55
  • 7
    Best answer IMO, as it depends only on URLs, not website-specific search boxes.
    – ThomasH
    Mar 2 '18 at 10:25
  • 6
    Apparently putting the %s in the domain part of the URL is now deprecated/broken in FF67 and up. See bugzilla.mozilla.org/show_bug.cgi?id=1553377
    – kmarsh
    Jul 9 '19 at 14:50
  • 3
    Although it's very counter-intuitive, it works (v69.0) Sep 30 '19 at 4:56
  • 1
    @Synetech Put it anywhere that is not "bookmarks toolbar" or a subfolder of that. I have never seen those bookmarks showing up anywhere except in menu→library→bookmarks→show all bookmarks, which is hidden enough in my opinion. I honestly have no idea what the difference between "bookmarks menu" and "other bookmarks" is. Feb 29 '20 at 0:31

The Add custom search engine extension lets you create a new search engine and customize it.


The actual, no-bookmark solution for this task:

  1. Open a web page that has a search on it (e.g. SuperUser: superuser.com).

  2. In the address bar, expand the address bar by clicking on it.

  3. If the website supports searching, it will show up in the bottom area of the expanded address bar. Click the plus icon that is enclosed in a green circle. This adds the web page’s search to the search engines in your preferences.

Screenshot of the bottom of Firefox's expanded addressbar when on superuser.com

If you want to set a keyword (e.g. su) for this search, follow these steps:

  1. Open the search preferences (or type the following URI in your address bar: about:preferences#search)
  2. In the table under the column for “Keyword”, double-click in order to set your own keyword.
  • 7
    It's sad that FF allows to do that only for web sites which explicitly provide this feature.
    – Monsignor
    Oct 7 '19 at 12:16
  • 2
    @Monsignor It's amazing how impossible it is it add a search engine in Firefox, compared to Chrome. I filed a bug against this at bugzilla.mozilla.org/show_bug.cgi?id=1683969 Dec 22 '20 at 23:02
  • Thank you so much for that reminder! I did this in the past, but browsers changed so much and it was said that using addons.mozilla.org would be the easiest way. But I end up with installing extensions, which is so painfully terrible getting served results that you know are bad. I did create xml or rdf or what ever files by hand 15 years ago, things were said to improve with every product generation. It's not the case, it's just driving "customers" to big corporations. :-(
    – LiveWireBT
    Mar 3 at 22:43
  • @LiveWireBT I assume this is how they earn money - by making sure that the search-engines that don't pay to have their name in the list will be locked out for most Firefox users. Oct 13 at 9:53

Your best bet is to go to the Mycroft Project and search for an already made search engine plugin.

If you can't find one you can create your own on the submissions page. Full instructions are available.

  • Wow this saved the day for me! This answer should be much higher upvoted. If you want to modify one of your default search engines, you may need to change the plugin name slightly
    – Pluto
    Mar 16 '18 at 22:12
  • I was able to add duckduckgo POST to my firefox using the Mycroft search engine.
    – user674669
    Jul 14 '18 at 6:08

Ready2Search is also an available free service that helps you do this for any site. It makes search plug-in for Internet Explorer, Firefox, Chrome, and Google Toolbar with great customization options (icons, query parameters, etc.).

Screenshot of Ready2Search


Alternative way for custom search

For an example Google Translate string: https://translate.google.com/m/translate#auto/en/%s so top answer here doesn't work. So I found a workaround with the plugin: add-custom-search-engine

And here we go:

enter image description here

Goes to :

enter image description here

  • 3
    This extension works perfectly to add a custom search engine. It should be a core part of Firefox, not an extension!
    – wisbucky
    Sep 24 '19 at 20:49
  • Thanks for this. This works great and is one of the more user-friendly solutions. I'd rather not use the bookmarks solution as I mirror my Firefox bookmarks from another browser. This solution ensures that my custom search engines don't get messed up when I do a mirror or syncing of bookmarks. Jan 15 '20 at 3:12

New solution (since the previous one does not work anymore):

Now if you visit a website like Twitter, Firefox will let you add the Twitter search easily (https://support.mozilla.org/en-US/kb/add-or-remove-search-engine-firefox). But in case you want to add another website that is not supported, you will need a web server like Apache. Below would be the solution for Twitter in case they don't use the search engine file opensearch.xml anymore.

Create a file, for example twitter_search.htm (this HTML source code is used on twitter.com, I just removed the / before opensearch.xml):

<link rel="search" type="application/opensearchdescription+xml" href="opensearch.xml" title="Twitter">

Then create another file, with the same name used in the href parameter of the previous HTML code, for example opensearch.xml with this content (this XML source code is used at https://twitter.com/opensearch.xml):

<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/" xmlns:moz="http://www.mozilla.org/2006/browser/search/">
<Description>Twitter Search</Description>
<Url type="text/html" method="get" template="https://twitter.com/search?q={searchTerms}"/>
<Image width="16" height="16">https://abs.twimg.com/favicons/favicon.ico</Image>

If needed, customize these files to replace the search URL, search form URL, name, description and icon. Put these 2 files in a folder of your web server and open the HTML file that you can find by visiting http://localhost in your web browser. You will be able to add your custom search engine to Firefox.

Previous solution (not working anymore):

Here is how I restored the Twitter search engine for Firefox, which seems to have been removed in Firefox 78 (you could create a search for other websites also based on this answer):

I tested with the Linux version of Firefox (Ubuntu package) but it should work with any operating system by creating the distribution folder / subfolders and search plugin file (https://wiki.mozilla.org/Mobile/Distribution_Files).

In my profile folder .mozilla/firefox/xxx.default/, there was a file search-metadata.json that contained a link to a non-existing file /usr/lib/firefox/distribution/searchplugins/locale/en-US/twitter.xml.

So I created this file with the following content (based on the documentation https://developer.mozilla.org/en-US/docs/Mozilla/Creating_MozSearch_plugins and search plugins already present https://packages.ubuntu.com/focal/amd64/firefox/filelist):

<?xml version="1.0" encoding="utf-8"?>
<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/">
  <Description>Twitter Search</Description>
  <Image height="16" width="16">data:image/x-icon;base64,
  <Url type="text/html" method="get" template="https://twitter.com/search?q={searchTerms}"/>

To get the Base64 of the latest Twitter icon that you can see above, I downloaded https://twitter.com/favicon.ico and used the Linux command base64 favicon.ico.

The following files were present in my profile folder but were not needed anymore so I removed them to avoid potential conflicts (you can backup files in case you want to reuse them): search-metadata.json, search.json, search.json.mozlz4.

The following answers did not work for me but contained useful information:



  • Speaking of search engines, there are many websites which will let the reader store the icon as a data url without knowing about base64.
    – jpaugh
    Jul 6 '20 at 15:12
  • 1
    @jpaugh indeed there are other ways to convert the image. The Linux base64 command has the advantage to not depend on an online third-party tool. There should be similar offline tools for other operating systems also.
    – baptx
    Jul 7 '20 at 20:37
  • Quite! JavaScript's btoa function might be the most available method. I'm imagining that your instructions are almost capable of being carried out by someone who knows nothing of XML or data urls, which is why I added an alternative.
    – jpaugh
    Jul 8 '20 at 20:00
  • I couldn't make this work. This statement from a Firefox developer says they've removed support for defining search engines with XML. Does this answer still work for any of you?
    – aude
    Jan 22 at 1:03
  • 1
    @aude I noticed a few months ago that my custom Twitter search engine was gone, even if the file is still present. So it looks like it is not working anymore. I used the official web search instead, for example twitter.com/search for Twitter. When I have a moment, I will try to find another way to add a custom search engine to Firefox.
    – baptx
    Jan 24 at 14:18

You can also make complex searches with multiple parameters, and here’s how.

For instance, imagine you have a two field search like this fictitious example:

http:// mymusic.com/search?artist=david+bowie&album=ziggy+stardust

You can make a new mm search like:


(in Firefox it would be a bookmark with keyword mm)

Then you can directly search for: mm david bowie,ziggy startdust (directly in the address bar)

I choose “,” as the separator, but it’s just an example. It’s perfectible, but you get the idea, and anything is possible.

※ Notice that some browsers (including Opera 12) may not execute your JavaScript in a new tab with no preloaded page.


It's as simple as right clicking in a search field.

The other advantage is that this process creates a bookmark for you. If you use something like XMarks to synchronize your bookmarks, you can access the same search functionality across all synchronised computers.

  • Unfortunately it doesn't seem to play nicely with the builtin Firefox Sync.
    – sourcejedi
    Apr 7 '13 at 11:49
  • This is what the accepted answer says. I realize it's 11 years later, but now, this answer has become redundant. Dec 22 '20 at 22:51

A bit late to the party, but for those finding this thread now you can click the search icon in the search bar when on the site you want if it has a green + icon on it.

  • 1
    What if it does not show the green + like on a site (e.g., eBay)?
    – Synetech
    Jul 13 '17 at 18:59

I believe he's referring to keyword.URL in Firefox's about:config page.

In Firefox's address bar type about:config, then search for keyword.URL and replace its contents with "https://blahblah.com/search?q=", for example.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.