---
updatedAt: 2026-11-06T16:10:06.000Z
agentTools:
  projectIndex: https://docs.esputnik.com/llms.txt
---

# Adding Custom Fonts

<HTMLBlock>{`
<p align="right" style="color: gray;">
  <a href="https://docs-ua.esputnik.com/docs/dodavannya-kastomnih-shriftiv-u-email-redaktori" style="color: gray; text-decoration: none;"><em>
    Read this article in Ukrainian ⮕
  </em></a>
</p>
`}</HTMLBlock>

Custom fonts let you create a unique style for your emails. You can add fonts from Google Fonts or upload your own and use them in the [email editor](https://docs.esputnik.com/docs/adaptive-email-builder-review) .

## Font Sets in eSputnik

eSputnik supports three font sets:

* **Safe** — system fonts supported by most email clients. Use these for reliable rendering.

<Image src="https://files.readme.io/e6ed3f81a1f0ddbda6ef7e212c2fb5cb377647834639cacebf9e02e33566567f-image01.webp" alt="Sample text AaEeFf — Email Template shown in four different safe system fonts" align="center" width="80% " />

* **Web** — web fonts supported by modern devices and browsers. Some email clients fall back to system fonts.

<Image src="https://files.readme.io/26252fa0da99be934987f8bfcf2690cf2c7cef108d49ad55ca7f7c4e0253615f-image03.webp" alt="Sample text AaEeFf — Email Template shown in four different web fonts" align="center" width="80%" />

* **Custom** — user-added fonts. Commonly used in banners. Support in text blocks depends on the email client and often falls back to system fonts.

<Image src="https://files.readme.io/6a390242c4b2922bab8925242850fd3a6c34bb440af9eb9614d85972cb31ff1d-image04.webp" alt="Four email banner examples using custom decorative fonts for headlines like Super Bowl Holiday and International Yoga Day" align="center" width="80% " />

Email clients that support custom fonts:

* iOS Mail and Apple Mail;
* Outlook 2016 and Outlook 2011 for Mac;
* Android App and Android Mail 2.3, 4.2, 4.4;
* Lotus Notes 8.

## Adding Your Font to eSputnik

1. Open an existing email or <Anchor target="_blank" href="https://docs.esputnik.com/docs/adaptive-email-builder-review#creating-a-message">create a new one</Anchor> .

2. In the **Email management** panel, click **Advanced settings** → **My fonts**.

<Image src="https://files.readme.io/361230f6e99f06eee69fee7796f15ad52ecdbc30a18432fa2e7cb1e39cb37c5a-image01.png" alt="Email Management Panel" align="center" width="80% " />

You can also open **My fonts** from the font list: select a text block, open the **Styles** tab, expand **Font Family**, and click **Connect another font**.

<Image src="https://files.readme.io/88adacc462ba646d41d1d2a9b9a79f46dd3c81d141d203c8b907d891790438aa-image.png" alt="You can also open My fonts from the font list" align="center" width="80%" />

3. Click **+ Add font**.

<Image src="https://files.readme.io/dd0c35a57c24bd40a326a17242fb6c8504af85c3d20b8823ceb5314f43d91f0e-image02.png" alt="Add New Font Button" align="center" width="80%" />

4. In the **Add new font** window, enter the font parameters (all required):

* Font name
* URL with CSS file
* Family

You can get font parameters in one of the following ways:

* [using the Google Fonts library](https://docs.esputnik.com/docs/how-add-custom-font#adding-your-font-to-esputnik) (or another font library),
* [creating your font](https://docs.esputnik.com/docs/how-add-custom-font#adding-your-own-font).

<Image src="https://files.readme.io/5dd8fb23eb5fe703ddb9579b11e2e26e95280870fedafbd48ecd9e30334a587d-image03.png" alt="Add New Font Window" align="center" width="80% " />

5. Click **Add** and confirm page restart.

<Image src="https://files.readme.io/451a64e88a2738bb33a7c4ea777d1b682a4c967f8f617f00b02d3309a02fd91b-image04.png" alt="Confirm Page Restart" align="center" width="80% " />

After the restart, the font appears in the list. If you have unsaved changes, you can postpone the restart. Save the email and reopen it to make the font available.

### Add a Font from Google Fonts

> 👍 Tip
>
> Open two browser tabs: one with eSputnik and one with Google Fonts. This makes copying values easier.

1. Go to [fonts.google.com](http://fonts.google.com) .
2. Find a font using search or filters.

If you know the font's name, use the search or filter fonts by category, language, and properties (number of styles, thickness, angle, width, etc.). Also, you can sort fonts by trending, popularity, novelty, or name.

<Image src="https://files.readme.io/3a8e0f6fd879229c4198cc80c06c99e77f0735058e982f1f094daf62aff19981-image09.webp" alt="Google Fonts library page with the Sort by dropdown and filter panel boxed in red, listing fonts such as Roboto and Open Sans" align="center" width="80%" />

> 🚧 Important
>
> Do not select multiple styles at once. Add each style separately (for example, Regular, then Bold). Each style is added as a separate font.

**Example**: add **Quantico** (**Regular 400**)

3. Open the font page and click the font field.

<Image src="https://files.readme.io/1dee2054a0225a1065a5ff18cd55f5523b199b3140eb02a9c457eeca848bf78c-image10.webp" alt="Google Fonts search results filtered by Futuristic feeling, with the Quantico font entry boxed in red" align="center" width="80%" />

4. Click **Get font**.

<Image src="https://files.readme.io/98f8db7e47d3ba49746c0aa481b2fc0c6b2e53b4f720846d1c68db4f5ded5f89-image11.webp" alt="Quantico font page on Google Fonts with the Get font button boxed in red" align="center" width="80%" />

5. Click **Get embed code**

<Image src="https://files.readme.io/a719e986491722bb6b540748455bd958b611904462665f387df41557b635396b-image12.webp" alt="Google Fonts selected font family page with the Get embed code button boxed in red" align="center" width="80%" />

6. In the styles list on the left:

* Leave only the **Regular 400** toggle enabled.
* From the top menu, select the **Web** tab and choose the \<link> integration method.
* Copy the value of the href attribute in the following format:
  `https://fonts.googleapis.com/css2?family=Quantico\&display=swap" rel="stylesheet"`.

<Image src="https://files.readme.io/3b119bd5b178beecf8af2fdd68a12055bf72c934e87fc7294e8d8ecc3b2f1453-image13.webp" alt="Google Fonts embed code panel with the Regular 400 Italic, Bold, and Bold Italic toggles boxed in red on the left and the CSS file link URL underlined in red on the right" align="center" width="80%" />

7. Switch to the **eSputnik** tab, go to **My fonts**, and click **+ Add font**.

<Image src="https://files.readme.io/459153f13e0174771d658cc9ba604887b1a9a476397f05bc245fa55c571f1c82-image05.gif" alt="Add New Font in eSputnik" align="center" width="80% " />

8. Paste the link into the **URL with CSS file** field.

<Image src="https://files.readme.io/453a04fe3a3ff93d0dd421dadd0e916e5455721572aaa70544c1d98bd8bf78cc-image06.png" alt="Paste URL with CSS File" align="center" width="80% " />

9. In the **Google Fonts** tab, in the **Quantico: CSS class** section, copy the font family value in the following format:

`"Quantico", sans-serif;`

<Image src="https://files.readme.io/51a9cfe086c40c6d7dff3ecedabb60e1ecb0e10f52ec6ecf6b3d2e6d6bb976a2-image16.webp" alt="Google Fonts CSS class code panel with the Quantico font-family value underlined in red" align="center" width="80%" />

10. In the **eSputnik** tab, paste this value into the **Family** field and click **Add**.

<Image src="https://files.readme.io/5d2de1d735dce23e2c412d90258fbe9e169ce43af52bda766033afe80b136988-image07.png" alt="Paste Family Value" align="center" width="80% " />

> ❗️ Important
>
> * The value for **Family** must be copied directly from the fonts’ library. The font with a random name will be invalid.
> * **My fonts** always loads a font by reference through the **URL with CSS file** field — similar to a `<link>` or `@import` — which keeps the email's HTML size small no matter how many weights you add. If you instead hand-write a `@font-face` rule with an embedded font declaration in the **Code Editor**, the font data is embedded directly in the email, which increases message size and adds to the risk of Gmail clipping on longer emails. For most campaigns, referencing the font through **My fonts** is the safer choice.

11. Click **Restart now**.

<Image src="https://files.readme.io/a1862aee27ed76c21b84d54b7285f63e7b6a05702febe8a4cdb721fd569eede0-image08.png" alt="Restart Now Button" align="center" width="80% " />

### Adding Your Own Font

Let's look at the **Font Squirrel** resource as an example.

To upload your font, you need to add the link to your server CSS file in the URL with CSS file field.

1. Go to [fontsquirrel](https://www.fontsquirrel.com/tools/webfont-generator) .

2. Accept the license terms.

3. Click **UPLOAD FONTS** to upload the font file in `TTF` format.

<Image src="https://files.readme.io/2032084fb65adeac42ebd1470a7bafceee4d62077d7bb28bb992949559f5ecfe-image19.webp" alt="Font Squirrel Webfont Generator page with the Upload Fonts button and Agreement checkbox boxed in red" align="center" width="80%" />

4. Click **DOWNLOAD YOUR KIT** and download the generated `ZIP` archive with the `stylesheet.css` file.

<Image src="https://files.readme.io/2da7f2812e90db06d0065503d8c5548901f0ce1658198347e13325232165b72e-image20.webp" alt="Font Squirrel Webfont Generator page with an uploaded font file and the Download Your Kit button boxed in red" align="center" width="80%" />

5. Add src to the file `stylesheet.css` to your server with the necessary font in the format  `woff2` (the script in this format would be in the kit), for example:

```css
@font-face {
  font-family: 'Manrope';
  font-style: normal;
  font-weight: 200;
  font-display: swap;
  src: url('https://fonts.gstatic.com/s/manrope/v1/xn7gYHE41ni1AdIRggOxSuXd.woff2') format('woff2');
  unicode-range: U+0400-045F,
                 U+0490-0491,
                 U+04B0-04B1,
                 U+2116;
}
```

6. Upload the `stylesheet.css` file to the server.

<Image src="https://files.readme.io/d4baf267ac6c83fc8a1e42b220e8ce794c52f7dcf575817c1f76cc458fc5ae19-image21.webp" alt="Downloaded webfont kit file listing with the stylesheet.css file boxed in red" align="center" width="80%" />

7. In the **eSputnik** tab, go to **My fonts**, and click **+ Add font**.

<Image src="https://files.readme.io/f303867054fbc7ee583cbad8ef6562f2f7be6aea266548024e609cb26f7da7e6-image05.gif" alt="Add New Font in eSputnik" align="center" width="80% " />

8. Paste the **Font name**, **URL with CSS file**, and **Family** in the fields and click **Add**.

## Use a Custom Font

1. Select the text in the block

2. Go to **Styles**, and open the **Font Family** drop-down menu.

<Image src="https://files.readme.io/bba69a9d88f8d0ac47b1299ae178213aad85889f18db82c2abdc624f81848724-image09.png" alt="Font Family Drop-down Menu" align="center" width="80% " />

3. Switch to the **Custom** tab and select the font.

<Image src="https://files.readme.io/6dcfc531492cf084996fb7c040595f009703008e5d3a8f1fede07fdc453cfd10-image10.png" alt="Select Custom Font" align="center" width="80% " />

The font is applied to the selected text.

## Edit or Delete a Font

1. Open **Advanced settings** → **My fonts**.

<Image src="https://files.readme.io/991ac15ba8caf745df66a94d1b86072b6b55e83e640d08c44eae5b503d826f38-image01.png" alt="Advanced Settings" align="center" width="80% " />

2. Click:

* the **Pencil** icon to edit the font;
* the **Trash** icon to delete the font.

<Image src="https://files.readme.io/b833bb7a7c7563271dc03c36d4acc2f2444544aeda48f85cee35c7ba698a0e4b-image11.png" alt="Edit or Delete Font" align="center" width="80% " />

## Custom Font Usage Details

1. If a font isn’t displayed in an email, check whether it’s available on the device where the email is opened. If the font isn’t available, the email client replaces it with a standard font.
2. Some fonts support only languages that use the Latin alphabet and can’t be used for languages that use the Cyrillic alphabet.
3. Do not use custom fonts for body text. Use them only in images — for example, in banners.
4. The email subject line and preheader are always displayed in a standard font defined by the email client.
5. When you use a custom font, consider how the email looks in clients that don’t support it. Fallback fonts may appear larger and break the layout. Always test the email and configure fallback font family, size, and spacing to ensure correct rendering.

## Troubleshooting: Google Font Not Displaying

If a **Web** font (including Google Fonts) that used to render correctly suddenly shows as a fallback font:

* **Gmail desktop is expected to ignore web fonts.** Gmail (and most webmail clients) doesn't load external font files for security/performance reasons and always falls back to a system font — this is normal behavior, not a bug, and applies regardless of any recent changes on your side.
* **Verify the fallback font family is set.** Without an explicit fallback, unsupported clients may substitute a font with different metrics, which can shift spacing or size.
* **Re-check the font link after any editor update.** If the way custom fonts are linked (`<link>` vs. `@import`) changed after a platform update, an existing **My fonts** entry could stop resolving — open **Advanced settings → My fonts** and confirm the **URL with CSS file** still loads correctly, then re-add the font if needed.