QR Codes

← Back

QR Codes are 2-dimensional bar-codes which may be encoded to carry a variety of information that is then read using a cell phone or other camera-based device. Gravatar provides simple QR codes which contain a link back to the main profile page for the requested profile.

Base Request

Making a QR request is likely to follow these steps (assuming you have an email address already):

  1. Create a valid email hash
  2. Build the URL to request a profile page
  3. Append .qr to that URL to indicate that you want the results in QR Code format

Once you have done the above, you should end up with a URL that looks something like this:


When you request that URL (you can do it in your browser) you should get a QR Code image in PNG format that will link directly to the profile page of the requested user when scanned by a QR-compatible device.

Request Options

The QR Code format supports a single option/parameter, size (or s), which is used to specify the edge length of the desired QR code image. Since they are square, you only need to specify a single pixel-based value:



Using the above QR code in an img tag produces the following:

<img src="https://www.gravatar.com/205e460b479e2e5b48aec07710c08d50.qr?s=150" />


  1. QR codes default to 80px by 80px if you don't supply a size parameter, just like normal Gravatars.
  2. The only data currently encoded in the QR Code is a link back to the profile page.
  3. splitbrain reviewed 11 different QR Code readers for iPhone
  4. 'Barcode Reader' is one of the more popular options for Android devices (find it in the Android Market)
  5. Mobile-barcodes.com maintains a list of barcode reading applications capable of reading QR Codes
  6. As with all profile data formats, profile requests will only resolve for the hash of the primary address on an account. Users may have multiple addresses on a single account, so while a Gravatar image request may return a result, a profile request for the same hash may not.