Create a gist now

Instantly share code, notes, and snippets.

WOFF 2.0 – Learn more about the next generation Web Font Format and convert TTF to WOFF2

Prolog

Google Chrome Developers says:

The new WOFF 2.0 Web Font compression format offers a 30% average gain over WOFF 1.0 (up to 50%+ in some cases). WOFF 2.0 is available since Chrome 36 and Opera 23.

Some examples of file size differences: WOFF vs. WOFF2

TTF to WOFF2 converting

Embed WOFF2 in CSS (with WOFF fallback)

@font-face {
	font-family: MyFont;
	src:
		url('myfont.woff2') format('woff2'),
		url('myfont.woff') format('woff');
}
Base64 Data-URI

Of course you can use WOFF2 as a Base64 encoded string:

@font-face {
	font-family: MyFont;
	src:
		url('data:font/woff2;base64,...') format('woff2'),
		url('data:font/woff;base64,...') format('woff');
}

Good to know

  • Please no serverside GZIP compression for WOFF files, because WOFF already contains compressed data.
  • Think about the correct mime type for WOFF 2.0 files (Google uses font/woff2. W3C recommends application/font-woff2):
NGINX: WOFF2 mime type
types {
    application/font-woff2  woff2;
}
APACHE: WOFF2 mime type
AddType  application/font-woff2  .woff2

Browser Support

  • Google Chrome 36
  • Opera 23
  • Firefox 35 (disabled by default)

Helpful links

Powered by

Sergej Müller

@kurtextrem

Is there anything for Windows users, without cURL?

@mathiasbynens

You can add Opera 23 to the list of browsers supporting WOFF 2.0.

@sergejmueller
Owner

@mathiasbynens
Verified, accepted, edited ;) Thanks.

@sergejmueller
Owner

@reklis
Thanks.

@rasmusfl0e

Just for the record: using windows powershell 3+ the equivalent code to the curl example would be:

Invoke-RestMethod -InFile "/local/path/font.ttf" -OutFile "/local/path/font.woff2" -ContentType "font/ttf" -Headers @{"accept"="font/woff2"} -Method POST -Uri http://188.226.250.76
@rasmusfl0e

Sadly - glyphs that have a horizontal offset (mostly occurring in icon fonts) are normalized to zero while their bounding boxes stay the same. Results are glyphs that should've been centered in a box is now aligned left... :(

@tomByrer

http://caniuse.com/#search=woff2

  • Chrome for Android 37, default browsers for Nexus 7 & Motorola Moto G
@danielguillan

What are the command-line options for converting TTF to WOFF2?

@mpybkk
mpybkk commented Nov 3, 2014

Wondering the same, is there still no command line options?

@shaunbent

+1 on a command-line option!

@CrocoDillon

What's missing from this gist is a feature test. We are using this one to detect WOFF2 supports https://github.com/filamentgroup/woff2-feature-test/blob/master/woff2.js

And serve WOFF or WOFF2 base64 encoded in a JSON file depending on the outcome. Basically like how The Guardian does it. This was an early prototype mimicking that behavior (without WOFF2 detection) http://codepen.io/CrocoDillon/pen/dkcbs , enjoy! :)

@paamayim
paamayim commented Dec 9, 2014

In case anyone else has tried to retrieve the google hosted .woff2 in latin subset only, it will show all subsets(for some reason). To avoid that, it's possible to include the full range of characters in the url:

http://fonts.googleapis.com/css?family=Open+Sans&text=abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ!%22#$%&'()*+,-./0123456789:;<=>?@[]^_`{|}~
See http://codepen.io/iautomation/pen/gbPwxe for an example

You can also download the full google font package on my site[ http://iautomation.us ] in case anyone wants to quickly grab the files to host locally..

@arebee
arebee commented Dec 16, 2014

To add the MIME type on IIS use:

appcmd set config /section:staticContent /+"[fileExtension='.woff2',mimeType='application/font-woff2']"
@majodev
majodev commented Jan 4, 2015

You can also easily get woff2 files (and all other formats for any combined subset/charset) of any Google web font via my lil' service google-webfonts-helper.

Thanks for this great gist, I will embed it in a special FAQ on the front page of my service ASAP.

@ElijahLynn

How come the woff2 mimetype has not been registered with the IANA?

http://stackoverflow.com/questions/27829408/why-isnt-woff2-in-the-mimetype-directory

@richiebee

use .ahtacess works for me

@zachleat
zachleat commented Feb 6, 2015

Can you add a warning here about Data-URI embedding multiple file formats? It’s not a recommended practice, it negates the page weight benefits offered by WOFF2 if you include both Data URIs in a single file.

@cvrebert

Google uses font/woff2

Could you please point to a specific example of this?

Edit: To answer my own question: http://www.google.com/fonts/
And here's hoping they rectify that: https://twitter.com/cvrebert/status/570155277648924672

@jimmywarting

http://onlinefontconverter.com has a online & a command tool to convert any font to woff2. You don't need to install any program. font-packs also works (you get one woff2 file for every font

@PhilAndrew

Does it work in SVG?

@boblauer

As someone who uses the Data-URI method, is there an option for loading the correct type from the server? As @zachleat said, it makes no sense to embed both in a single file.

@blaja
blaja commented Jul 9, 2015

You can also add FF 39 stable to the list, it is enabled by default now, which is great.

@jungshik

W3C now recommends font/woff and font/woff2 for WOFF and WOFF2. See
http://dev.w3.org/webfonts/WOFF2/spec/#IMT

@nfroidure

Hi guys. Made a NodeJS wrapper for the Google lib, thought you could be interested in adding it to this document: https://github.com/nfroidure/ttf2woff2

@jimmylee

Is there a way to convert WOFF 2.0 to WOFF 1.0?

@Haroenv
Haroenv commented Aug 13, 2016

Safari 10 should have support for it too.

@anthony-geoghegan

@jungshik is right. The W3C now recommend using font/woff2 as the MIME type: https://www.w3.org/TR/WOFF2/#IMT

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment