CTAN Comprehensive TeX Archive Network

Directory macros/unicodetex/latex/fontspec


The FONTSPEC package

The fontspec package provides an automatic and unified interface for loading fonts in . and Lua (the latter through the luaotfload package) allows a direct interface to fonts which may be loaded by their name or filename, so no manual font installation is required.

This package also provides access to the large number of font features available with OpenType (and other) fonts, including upper and lower case numbers, proportional and monospaced numbers, swash letters, ligature control, and many many others.


See the PDF documentation for complete user information (including examples):

texdoc fontspec

Additional online documentation is provided at: http://latex3.github.io/fontspec/

The package code is documented in typeset PDF form via

texdoc fontspec-code


This package is distributed under the terms and conditions of the Project Public License (LPPL), version 1.3a or higher.

The maintainer of the package is Will Robertson and the 3 project.

Summary of user commands

To define commands for selecting fonts efficiently through a document:

\newfontfamily\<font switch>{<font name>}[<font options>]
\newfontface  \<font switch>{<font name>}[<font options>]

To select the default document fonts:

\setmainfont{<font name>}[<font options>]
\setsansfont{<font name>}[<font options>]
\setmonofont{<font name>}[<font options>]

To define an ad hoc font family individually:

\fontspec{<font name>}[<font options>]

To specify features to be used for every subsequently defined font:

\defaultfontfeatures{<default font options>}
\defaultfontfeatures+{<add to default font options>}

To specify features to be used for specific fonts:

\defaultfontfeatures[<font name or switch>]{<default font options>}
\defaultfontfeatures+[<font name or switch>]{<add to defaults>}

To add features to the font family currently in use:

\addfontfeatures{<font options to add>}

Package details

Release versions of fontspec are available from CTAN: http://www.ctan.org/pkg/fontspec

Development and historical versions are available from Github: http://github.com/latex3/fontspec

Please offer suggestions and file bug reports in the issue tracker: http://github.com/latex3/fontspec/issues

If you are running Live, you can update to the latest version of this package by running

tlmgr install fontspec

If you wish to manually download the latest release version from CTAN, get the pre-built TDS package and extract it into your local texmf tree:


Historical releases are available via GitHub: https://github.com/latex3/fontspec/releases https://github.com/latex3/fontspec/tags

If you wish to use the latest development version from Github, use git to obtain the latest repository code with

git clone git://github.com/latex3/fontspec.git

Having obtained the package from Github, install the package code by running

l3build install

This will compile the documentation and install all necessary files in your local texmf tree. Depending how your distribution is configured you may then need to update the filename database with texhash.

Download the contents of this package in one zip archive (1.2M).

fontspec – Advanced font selection in XeLaTeX and Lua

Fontspec is a package for XeLaTeX and Lua. It provides an automatic and unified interface to feature-rich AAT and OpenType fonts through the NFSS in running on or Lua engines.

The package requires the l3kernel and xparse bundles from the 3 development team.

Bug trackerhttps://github.com/latex3/fontspec/issues
Version2.9e 2024-05-11
LicensesThe Project Public License 1.3c
Copyright2004–2022 Will Robertson
2009–2013 Khaled Hosny
2022–2024 The project
MaintainerThe Project Team
Will Robertson
TDS archivefontspec.tds.zip
Contained inTeX Live as fontspec
MiKTeX as fontspec
Font sel

Guest Book Sitemap Contact Contact Author