font-family

Examples

Basic example

Use utilities like font-sans and font-mono to set the font family of an element:

<p class="font-sans ...">The quick brown fox ...</p><p class="font-serif ...">The quick brown fox ...</p><p class="font-mono ...">The quick brown fox ...</p>

Using a custom value

Use the font-[<value>] syntax to set the font family based on a completely custom value:

<p class="font-[Open_Sans] ...">  <!-- ... --></p>

For CSS variables, you can also use the font-(family-name:<custom-property>) syntax:

<p class="font-(family-name:--my-font) ...">  <!-- ... --></p>

This is just a shorthand for font-[family-name:var(<custom-property>)] that adds the var() function for you automatically.

Responsive design

Prefix a font-family utility with a breakpoint variant like md: to only apply the utility at medium screen sizes and above:

<p class="font-sans md:font-serif ...">  <!-- ... --></p>

Learn more about using variants in the variants documentation.

Customizing your theme

Use the --font-* theme variables to customize the font family utilities in your project:

@theme {  --font-display: "Oswald", "sans-serif"; }

Now the font-display utility can be used in your markup:

<div class="font-display">  <!-- ... --></div>

You can also provide default font-feature-settings and font-variation-settings values for a font family:

@theme {  --font-display: "Oswald", "sans-serif";  --font-display--font-feature-settings: "cv02", "cv03", "cv04", "cv11";   --font-display--font-variation-settings: "opsz" 32; }

If needed, use the @font-face at-rule to load custom fonts:

@font-face {  font-family: Oswald;  font-style: normal;  font-weight: 200 700;  font-display: swap;  src: url("/fonts/Oswald.woff2") format("woff2");}

If you're loading a font from a service like Google Fonts, make sure to put the @import at the very top of your CSS file:

@import url("https://fonts.googleapis.com/css2?family=Roboto&display=swap");@import "tailwindcss";@theme {  --font-roboto: "Roboto", sans-serif; }

Browsers require that @import statements come before any other rules, so URL imports need to be above imports like @import "tailwindcss" which are inlined in the compiled CSS.

Learn more about customizing your theme in the theme documentation.