Font resources

Stay organized with collections Save and categorize content based on your preferences.

A font resource defines a custom font that you can use in your app. Fonts can be individual font files or a collection of font files, known as a font family and defined in XML.

Also see how to define fonts in XML or instead use Downloadable Fonts.

Bundled font

You can bundle fonts as resources in an app. Fonts are compiled in the R file and are automatically available in the system as a resource. You can then access these fonts with the help of the font resource type.

file location:

res/font/filename.ttf (.ttf, .ttc, .otf, or .xml)
The filename is used as the resource ID.

resource reference:

In XML: @[package:]font/font_name

syntax:

<?xml version="1.0" encoding="utf-8"?>
<font-family>
  <font
    android:font="@[package:]font/font_to_include"
    android:fontStyle=["normal" | "italic"]
    android:fontWeight="weight_value" />
</font-family>

elements:

<font-family>

Required. This must be the root node.

No attributes.

<font>

Defines a single font within a family. Contains no child nodes.

Attributes:

android:fontStyle

Keyword. Defines the font style. This attribute is used when the font is loaded into the font stack and overrides any style information in the font's header tables. If you don't specify the attribute, the app uses the value from the font's header tables. The constant value is either normal or italic.

android:fontWeight

Integer. The weight of the font. This attribute is used when the font is loaded into the font stack and overrides any weight information in the font's header tables. The attribute value must be a multiple of 100 between 100 and 900, inclusive. If you don't specify the attribute, the app uses the value from the font's header tables. The most common values are 400 for regular weight and 700 for bold weight.

example:

XML file saved at res/font/lobster.xml:

<?xml version="1.0" encoding="utf-8"?>
<font-family xmlns:android="http://schemas.android.com/apk/res/android">
    <font
        android:fontStyle="normal"
        android:fontWeight="400"
        android:font="@font/lobster_regular" />
    <font
        android:fontStyle="italic"
        android:fontWeight="400"
        android:font="@font/lobster_italic" />
</font-family>

XML file saved in res/layout/ that applies the font to a TextView:

<?xml version="1.0" encoding="utf-8"?>
<EditText
    android:fontFamily="@font/lobster"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:text="Hello, World!" />

Downloadable font

A downloadable font resource defines a custom font that you can use in an app. This font isn't available in the app itself. Instead, the font is retrieved from a font provider.

file location:

res/font/filename.xml The filename is the resource ID.

resource reference:

In XML:@[package:]font/font_name

syntax:

<?xml version="1.0" encoding="utf-8"?>
<font-family
    android:fontProviderAuthority="authority"
    android:fontProviderPackage="package"
    android:fontProviderQuery="query"
    android:fontProviderCerts="@[package:]array/array_resource" />

elements:

<font-family>

Required. This must be the root node.

attributes:

android:fontProviderAuthority

String. Required. The authority of the font provider that defines the font request.

android:fontProviderPackage

String. Required. The package name of the font provider to be used for the request. This is used to verify the identity of the provider.

android:fontProviderQuery

String. Required. The string query of the font. Refer to your font provider's documentation on the format of this string.

android:fontProviderCerts

Array resource. Required. Defines the sets of hashes for the certificates used to sign this provider. This is used to verify the identity of the provider and is only required if the provider isn't part of the system image. The value can point to a single list (a string array resource) or a list of lists (an array resource), where each individual list represents one collection of signature hashes. Refer to your font provider's documentation for these values.

example:

XML file saved at res/font/lobster.xml:

<?xml version="1.0" encoding="utf-8"?>
<font-family xmlns:android="http://schemas.android.com/apk/res/android"
    android:fontProviderAuthority="com.example.fontprovider.authority"
    android:fontProviderPackage="com.example.fontprovider"
    android:fontProviderQuery="Lobster"
    android:fontProviderCerts="@array/certs">
</font-family>

XML file saved in res/values/ that defines the cert array:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string-array name="certs">
      <item>MIIEqDCCA5CgAwIBAgIJA071MA0GCSqGSIb3DQEBBAUAMIGUMQsww...</item>
    </string-array>
</resources>

XML file saved in res/layout/ that applies the font to a TextView:

<?xml version="1.0" encoding="utf-8"?>
<EditText
    android:fontFamily="@font/lobster"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:text="Hello, World!" />