Custom fonts

Advanced

We do not support code customizations. This guide offers a basic reference for advanced users familiar with HTML and CSS. Always test code changes on a duplicated, unpublished version of your theme. For assistance, we recommend finding a professional developer through Shopify Experts ↗ or Task Husky ↗.

With Custom CSS, it's possible to add custom fonts with a few edits to your theme code. Custom fonts are uploaded to Shopify Files and then applied manually to different text elements in the Code editor.

Before deciding to use a custom font, we highly recommend considering one of the hundreds of fonts in Shopify's Font Picker as your first choice, since they are fully supported by all our themes.

Custom fonts will not appear as an option in the Theme Editor's font selector.

Watch video tutorial

Upload fonts to Shopify Files

All font files should be in WOFF and WOFF2 formats. While TTF and OTF can be used, they are not web-supported fonts and may cause issues. You can convert font formats with free tools like CloudConvert.

Using custom fonts may contribute to longer load-times. See our article about balancing features and customizations with your online store speed.

STEPS

In your Shopify Admin:

  1. Go to Content > Files and click Upload files to add your WOFF and WOFF2 files.

  2. Keep this window open for the next step.

Add fonts with Custom CSS in theme editor

After uploading your font files, you can import them in your Theme settings using the Custom CSS field.

STEPS

In your Shopify Admin:

  1. Click Duplicate on your current theme.

  2. Click Customize on the duplicated, unpublished theme version.

In your theme editor (Customize):

  1. Go to Theme settings > Advanced.

  2. Click to open the Custom CSS tab.

  3. Copy and paste the following code on a new line:

    @font-face {
      font-family: "FONT NAME";
      src: url("FONT URL") format("woff"),
      url("FONT URL") format("woff2");
    }
  4. Replace FONT NAME with the exact name of your font. Example:

    @font-face {
      font-family: "Custom Font Name";
      src: url("FONT URL") format("woff"),
      url("FONT URL") format("woff2");
    }
  5. In your Shopify files, click the link icon to copy the URL and replace FONT URL for both the WOFF and WOFF2 formats. Example:

    @font-face {
      font-family: "Custom Font Name";
      src: url("https://cdn.shopify.com/s/files/1/0518/6692/7292/files/DMSans-Regular.woff?v=1663348292") format("woff"),
      url("https://cdn.shopify.com/s/files/1/0518/6692/7292/files/DMSans-Regular.woff2?v=1663348302") format("woff2");
    }
    
  6. Click Save.

  7. Enter or paste the CSS code into the Custom styles box.

  8. Click Save.

  9. Click Preview to review your changes.

    Use the preview link to further test your changes on multiple browsers and devices.

  10. After testing, you can go to your Theme library to Publish the duplicated theme with your changes.

Apply fonts to theme text

Once you've added your font, you can apply it manually to elements of your theme with the CSS code below.

Apply fonts globally to Logo, Headings, and Body text and apply fonts specifically to Navigation menus Buttons.

Logo, Headings, and Body text

Stiletto groups theme text into 3 categories: Logo, Headings, and Body. Use the code below to override the font settings in your theme editor.

STEPS

In your theme editor (Customize):

  1. Copy and paste the code below on a new line in the Custom CSS field of your theme settings.

    :root {
    /*
      --font-logo: unset;
      --font-logo-weight: unset;
      --font-logo-style: unset;
      */
    /*
      --font-heading: unset;
      --font-heading-weight: unset;
      --font-heading-style: unset;
      */
    /*
      --font-body: unset;
      --font-body-weight: unset;
      --font-body-style: unset;
      */
    }

    --font-logo applies to the site title (when no logo image is used).

    --font-heading applies to headings and subheadings for pages and sections.

    --font-body applies to paragraph, navigation, product listing, and button text.

  2. For each font you want to change, replace unset with the custom font name and delete the comment tags (/* and / on either side) . Example:

    :root {
    --font-logo: Custom Font Name;
    --font-logo-weight: unset;
    --font-style: unset;
    }
  3. (Optional.) If your font has multiple weights or styles, replace unset with the values for those properties. Example:

    :root {
      --font-logo: Custom Font Name;
      --font-logo-weight: 400;
      --font-style: italic;
    }
  4. Click Save.

    Click Preview Store to test and troubleshoot your code before publishing the theme.

The Body font applies to navigation and button text. However, you can apply fonts specifically to the Navigation menu items and Buttons

STEPS

In your theme editor (Customize):

  1. To apply fonts only to navigation menu items, paste and edit the following code on a separate line:

    .header__links-list,.navigation__submenu-list {
      font-family: "Custom Font Name" !important;
    }
    
  2. To apply fonts only to Buttons, paste and the following code on a separate line:

    .btn {
      font-family: "Custom Font Name" !important;
    }
    
  3. Click Save.

    Click Preview Store to test and troubleshoot your code before publishing the theme.

Apply fonts to specific elements

Note | If your require assistance, we recommend contacting Shopify Experts ↗ or Task Husky ↗.

Applying fonts to specific elements requires knowing how to use your browser's Inspector tool ↗ and familiarity with CSS selectors ↗.

If that sounds like you, you can find and copy the CSS selector with the Inspector tool, then edit and use the following example below:

CSS-selector-name {
  font-family: "Custom Font Name" !important;
}

Add fonts with custom.css file

While we recommend using the available Custom CSS settings in the theme editor, you can use Stiletto’s custom.css file to organize your custom code in a single place.

Enable useCustomCSS

To import the custom.css file, you need to enable useCustomCSS in the theme-globals.liquid file.

STEPS
  1. Open the theme-globals.liquid file in the Snippets folder.

  2. Find the useCustomCSS variable and set it to true.

    
    
    
    {% assign useCustomCSS = false %}
    
    
    
  3. Open the custom.css file in the Assets folder.

  4. Add your custom code to import font files and apply them to your theme text.


Related links

Edit theme JavaScript Custom JavaScript events Custom Liquid Custom CSS Custom fonts

Last updated