Setting a global font family in React


Borislav Hadzhiev

Last updated: Apr 24, 2022


Photo from Unsplash

Setting a global font family in React #

To set a global font family in React, set the font-family style on the html element in your index.css file and import the file in your index.js file. Global CSS should be imported in index.js to make sure it's loaded on all pages of your React app.

Here is an example of setting the font-family CSS property in our index.css file.

body, html { font-family: Roboto, Helvetica, sans-serif; /* 👇️ or use Operating system default fonts 👇️ */ /* font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen', 'Ubuntu', 'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif; */ }

And here is how we would import the index.css file in our index.js file.

// 👇️ import css import './index.css'; import {createRoot} from 'react-dom/client'; import App from './App'; const rootElement = document.getElementById('root'); const root = createRoot(rootElement); root.render( <App /> );

The example above assumes that your index.css file is located in the same directory as your index.js file.

When importing global CSS files in React, it's a best practice to import the CSS file into your index.js file.

The index.js file is the entry point of your React application, so it's always going to be ran.

On the other hand, if you import a CSS file into a component, the CSS styles might get removed once your component unmounts.

If you have downloaded a font and need to load it from a local file, create afonts directly in your src folder and move your fonts there.

Now you can import them in your index.css file.

The following example assumes that you have downloaded the Poppins font into your src/fonts directory.

body, html { font-family: 'Poppins', sans-serif; } @font-face { font-family: 'Poppins'; src: local('Poppins'), url(./fonts/Poppins-Regular.ttf) format('truetype'); } @font-face { font-family: 'Poppins'; font-weight: 900; src: local('Poppins'), url(./fonts/Poppins-Bold.ttf) format('truetype'); } @font-face { font-family: 'Poppins'; font-weight: 900; src: local('Poppins'), url(./fonts/Poppins-Black.ttf) format('truetype'); }

For .ttf format we pass truetype to the format() function.

For .woff format, we pass woff to the format() function.

For .otf format, we pass opentype to the format() function.

You can download a font by picking one from google fonts and clicking on the Download all button.

If you are setting a global font family based on external styles, e.g. fromgoogle fonts CDN, make sure to load the style in your public/index.html file.

For example, with google fonts, you can click on the chosen font and then click "Select this style" and you will get a link you can add to the head tag of your index.html file.

google fonts add style

<!DOCTYPE html> <html lang="en"> <head> <!-- 👇️ loading font-family from google fonts --> <link rel="preconnect" href="" /> <link rel="preconnect" href="" crossorigin /> <link href="" rel="stylesheet" /> <title>React App</title> </head> <body> <noscript>You need to enable JavaScript to run this app.</noscript> <div id="root"></div> </body> </html>

After you copy the link tag in the head section of your index.html file in the public/ directory, you still have to set the font-family property in your index.css file.

body, html { font-family: 'Square Peg', cursive; }

The value of the font-family property will depend on the specific font you selected. You should be able to find it right below where you got the link tag from.

I wrote a book in which I share everything I know about how to become a better, more efficient programmer.
book cover
You can use the search field on my Home Page to filter through all of my articles.