How to Use the Sports Reference Linker

Add your blog to our player newsfeeds

This tool allows you to automatically (via just a single click):

  • Add links to player pages in your blog posts,
  • bulletin board posts, and

You just need to add our bookmarklet and then click it whenever you want to link to our Sports Reference pages. Javascript bookmarklets are like bookmarks, but slightly different. A bookmark contains an address for a webpage and clicking on it sends you to that page. A bookmarklet is a set of javascript instructions for the browser and when you click on it, your browser runs the javascript. Sometimes this will send you to a different page, but often it may just change what you see on the current page. Ours adds links to players on Sports Reference sites to the articles you are writing.

Note: that due to a request from Google we are now adding nofollow attributes to both the links we put on your pages and also the links that appear from our sites to your site. The links still work, but Google no longer considers them for search result purposes.

For, the Linker will direct your users to the same language used on this page. Switch to a different language if you want the player links to direct your users to a different language.

Choose a Different Language: Português / English / Français / Italiano / Deutsche / Español

Video Explanation of the Process

Add the Bookmarklet Linker Bookmarklet

To add to your browser you need to do one of the two following things.

  1. Click on, hold, and then drag the link above to your bookmarks or bookmark bar (works in FireFox, Safari, and Chrome). Note that your bookmark bar must be visible (under View or Bookmarks in Chrome, View -> Toolbars in Firefox or View -> Favorites bar in Safari), or
  2. Right Click on the link above and add to favorites or bookmarks (doesn't work for Chrome). Internet Explorer will ask you if you really want to do this. It asks this for all cases where you create a javascript bookmarklet since there is the possibility of security issues from untrustworthy sites.

To make sure you've done it right you can test it with player names. If it doesn't work, you can edit the bookmark url which should appear like the following. Note that there are encoded symbols (necessary for the bookmarklet in some browsers) listed below that may not appear when clicking edit. These are of the form %X or %XX).

Linker Limitations and Accent Marks

Due to the large number of players on our football site, we are restricting the linker to the 55,000 or so most popular players on the site. This list updates daily, and is calculated both for long-term and short-term popularity. Generally, any player who played in the last four seasons and has 25 games plus goals combined will be matched.

Also, we do match diacritics like "Mario Mandžukić", but we will also try to match "Mario Mandzukic" and get that linked. However, a partially correct rendering, like “Mario Mandzukić“ may not get linked.

Single-Named Players (Mononyms)

Players known by a single name like "Isco", "Neymar", "Marta", "Jo", and "Fred" are difficult for our system to match as a name like "Joe Hart" may first correctly match the English goalkeeper, but then also get matched to the Brazilian Jo. To manage this issue, we only match mononyms when they are wrapped by underscores.

So if you are writing an article for the first entry for Hulk, you will want to write it as _Hulk_. For example:

Hulk was a forward for Zenit
    will need to be written as
_Hulk_ was a forward for Zenit

for a link to appear in your text.

We will then match this name and also remove the underscores when wrapping the name in the appropriate link. We apologize for this inconvenience, but it is the only way we can manage to link these one-word names.

How to Use this with Blogs or Bulletin Boards

See a list of supported blog software below.

PLEASE SAVE ANY WORK prior to using the bookmarklet. While we have made a serious effort to never lose any of your content, we can not make any guarantees.

Generally, the easiest way to use the tool is to just write up your post in the blog text box and click the bookmarklet in your brower. The tool grabs the text you wrote, runs it through our player linker and returns the text with links enclosed.

When using with blogs or bulletin boards for adding links to posts while composing, you must click the bookmarklet while using the "Edit Html" or "Html" view rather than the "Visual", "Rich Text", or "Compose" View. You can switch back and forth from the two views, so you can write in the Visual view, switch to the HTML view and click the bookmarklet.


  1. Save your draft
  2. Change into HTML view if needed
  3. Click the linker bookmarklet
  4. A Working notice should appear, and when it disappears all of the player names should be linked.

Test the bookmarklet here

Currently Supported Webpages and Software

  • Substack Newsletters
  • WordPress
  • TypePad
  • Joomla
  • MovableType Enterprise 4 (may also work in 5, but have not tested)
  • phpBB
  • invision
  • vBulletin
  • Xenforo
  • Request support for other software


  • Names inside of links will be matched as well, to avoid this write something like "Eden Hazard" with two spaces rather than "Eden  Hazard" with one space. It will render the same way in HTML since extra spaces are collapsed by default.
  • Player names will be bolded and linked automatically.
  • Names with multiple associated players will go to the search engine results for that name or to the common choice for that name.
  • Search is by longest names to shortest names
  • No matching will occur across hard line returns.
  • A name with a </a> after it will not be matched, so it won't overwrite existing links.

About launched (June 13, 2018) with domestic league coverage for England, France, Germany, Italy, Spain, and United States. Since then we have been steadily expanding our coverage to include domestic leagues from over 40 countries as well as domestic cup, super cup and youth leagues from top European countries. We have also added coverage for major international cups such as the UEFA Champions League and Copa Libertadores.

FBref includes what we believe is one of the most complete sources for women's soccer data on the internet. This includes the entire history of the FIFA Women's World Cup as well as recent domestic league seasons from nine countries.

In collaboration with StatsBomb, we are including advanced analytical data such as xG and xA for select competitions. For more information on the expected goals model and which competitions are covered, see our xG explainer.

Note that player records are likely not complete for their careers. Players may come from or move to leagues we don't currently cover. This issue will go down over time, as we add new leagues and seasons. We will never in the future have less data than we do today. FBref is currently ad-free. The only payment we will ask for is that you let us know if you find an issue, so we can get better and better.

You can sign up to receive an e-mail when new countries and features launch.

For more information, see our Launch Blog Post, the overall leagues/competition page with details on leagues and seasons we include, or our About Page. Let us know if you find an issue or have a suggestion.

FBref is one of seven sites.