How the Firefox Address Bar Ranks Search Suggestions

This article provides a comprehensive overview of how the Firefox address bar, commonly known as the Awesome Bar, ranks suggestions as you type. By utilizing a specialized algorithm called "Frecency," Firefox evaluates your browsing history, bookmarks, and currently open tabs based on how frequently and recently you have interacted with them. Understanding this ranking system reveals how the browser predicts your destination by assigning specific point values to different types of user actions, URL matches, and adaptive learning patterns.

The Core Algorithm: Frecency

At the heart of the Firefox address bar is the "Frecency" algorithm, a portmanteau of the words "frequency" and "recency." Every unique URL stored in the browser's database is assigned a dynamic Frecency score. When you type into the address bar, Firefox searches your database for matches in URLs, page titles, and bookmark tags, and then orders the dropdown suggestions from the highest Frecency score to the lowest.

How Browsing History is Ranked

Standard browsing history is evaluated using two main metrics: the "visit type" (how you arrived at the page) and "recency buckets" (when you visited the page).

Visit Types Not all page views are treated equally. Firefox assigns different point bonuses depending on the user intent behind the navigation:

  • Typed URLs: Typing a web address directly into the address bar and pressing Enter yields the highest point bonus, as it demonstrates deliberate intent.
  • Followed Links: Clicking a standard link on a webpage awards a moderate amount of points.
  • Redirects and Frames: Automatic redirects or pages loaded inside iframes receive very few or zero points, preventing background web activity from cluttering your suggestions.

Recency Buckets Because your browsing habits change over time, Frecency scores decay. Firefox categorizes your past visits into tiered time "buckets":

  • Visited within the last 4 days (100% weight)
  • Visited within the last 14 days (70% weight)
  • Visited within the last 31 days (50% weight)
  • Visited within the last 90 days (30% weight)
  • Visited more than 90 days ago (10% weight)

Firefox calculates a URL's score by multiplying the visit type points by the weight of the time bucket. Consequently, a site you visited twice today will likely outrank a site you visited ten times four months ago.

How Bookmarks are Ranked

Bookmarks are treated as high-priority items in the Awesome Bar. When you bookmark a webpage, Firefox immediately applies a large, permanent base boost to that URL's Frecency score. This ensures that even a newly bookmarked page with only a single visit, or an old bookmark you haven't visited in a year, will still rank competitively against your active browsing history.

Additionally, bookmarks are ranked using metadata:

  • Bookmark Visits: Clicking a bookmark to navigate to a site awards a high visit-type bonus, second only to typing the URL directly.
  • Tags and Titles: Firefox allows users to add custom tags and titles to bookmarks. If the text you type into the address bar matches a bookmark tag, Firefox heavily weights that result, pushing it toward the top of the list.

How Open Tabs are Ranked

Currently open tabs largely bypass the standard Frecency competition through Firefox’s "Switch to Tab" feature. The browser actively indexes the URLs and page titles of all tabs open across your current session.

If your typed query matches an open tab, Firefox prioritizes it by injecting a "Switch to Tab" suggestion near the top of the address bar results. While the open tab still relies on text-matching relevance, its status as an active tab overrides the need for a high historical Frecency score. This prevents tab duplication by encouraging you to jump to the existing tab rather than loading the webpage a second time.

Adaptive Learning (Input History)

Beyond raw Frecency scores, the Awesome Bar uses adaptive learning to personalize rankings based on your past selections.

When you type a specific string of letters and click on a resulting suggestion, Firefox records that exact pairing in its "input history." For example, if you type "fi" and select a specific financial website from the middle of the suggestion list, Firefox remembers this action. The next time you type "fi", that specific financial site receives an adaptive boost that overrides standard Frecency calculations, placing it at the very top of your suggestions. The more often you select that URL after typing those specific letters, the stronger that association becomes.