Fluorescent
Eclipse
Eclipse
  • Get started
    • Migrating to Eclipse
    • Theme license
  • FAQs
  • Changelog
    • Update your theme
  • General
    • Editing themes
      • Dynamic content with metafields
      • Edit default theme content
      • Multiple languages
      • Unique content for markets
      • Customizing your site
      • H1 heading tags
    • Image guide
      • Web ready photography
      • Image sizes
      • File formats
      • Theme image settings
    • SEO for Shopify
    • Online store speed
    • Accessibility
  • Theme settings
    • Theme settings
      • Social media
    • Theme styles
    • Fonts
    • Colors
  • Corner rounding
  • Pages
    • Page templates
      • Using templates
      • Customize page styles
      • Create and assign templates
    • Demo layouts
    • About page
    • Home page
    • Blog page
    • Blog post
    • Contact page
    • Password page
    • Search page
  • Sections
    • Sections
      • Using sections
      • Content blocks
    • Blog posts
    • Collapsible content
    • Collection list
    • Contact form
    • Featured collection
    • Featured links
    • Feature product
    • Grid
    • Icon with text columns
    • Image hero
    • Image with text
    • Multi-column
    • Newsletter
    • Rich text
    • Scrolling content
    • Shop the look
    • Shoppable feed
    • Slideshow
    • Video
    • Video hero
    • Video with text
    • Custom Liquid
  • Header
    • Announcement bar
    • Header
      • Layout and style
      • Logo
      • Transparent header
      • Mega menu
      • Language and Currency
    • Impact logo
    • Search
  • Footer
    • Footer
      • Image Text and Socials
      • Links block
      • Newsletter and Socials
      • Language and Currency
      • Custom Liquid
  • Products
    • Product listings
      • Product card styles
      • Sale and sold out badges
      • Quick shopping
    • Prices and currencies
    • Swatches
      • Use default colors
      • Use custom colors
      • Use custom images
  • Product pages
    • Product page
      • Gift card product
    • Media gallery
      • Media grouping
    • Product overview blocks
      • Description
      • Price
      • Buy buttons
      • Collapsible row
      • Complementary products
      • Custom option
      • Featured icon with text
      • Icon with text
      • Inventory status
      • Image block
      • Popup block
      • Product rating
      • Text block
      • Share icons
      • Custom Liquid
    • Variant selector
      • Info popup
    • Sticky add-to-cart
    • Sibling products
    • Product recommendations
  • Collections
    • Collection page
      • Banner
      • Product grid
      • Promotion tiles
      • Filters and sorting
    • Collection list page
  • Cart
    • Cart
    • Free shipping bar
    • Cross sells
  • Popups
    • Popups
  • Support
    • Support policy
    • Shopify vs Theme issues
    • Store access requests
  • Advanced
    • Custom CSS
    • Custom fonts
Powered by GitBook
On this page
  • Upload fonts to Shopify Files
  • Add fonts with Custom CSS in theme editor
  • Apply fonts to theme text
  • Apply fonts to specific elements
  • Adding fonts with custom.css file
  • Enable useCustomCSS

Was this helpful?

  1. Advanced

Custom fonts

Last updated 4 months ago

Was this helpful?

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 unpublished theme copies. For assistance, we recommend reaching out to a .

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. (Custom fonts will not appear as an option in the Theme Editor's font selector.)

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

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 .

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

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.

Eclipse groups theme text into 4 categories:

  • Headings (includes logo text)

  • Body

  • Navigation

  • Buttons.

Use the code in the steps 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-family-heading: unset;
      --font-weight-heading: unset;
      --font-style-heading: unset;
      */
    /*
      --font-family-body: unset;
      --font-weight-body: unset;
      --font-style-body: unset;
      */
    /* 
      --font-family-navigation: unset;
      --font-weight-navigation: unset;
      --font-style-navigation: unset;
      */
    /* 
      --font-family-button: unset;
      --font-weight-button: unset;
      --font-style-button: unset;
      */
    }

    --font-heading applies to the store name, headings, and subheadings for pages and sections.

    --font-body applies to lines of text and product listings.

  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-family-heading: Custom Font Name;
    ---font-weight-heading: unset;
    --font-style-heading: unset;
    }
  3. (Optional.) If your font has multiple weights or styles, replace unset with the values for those properties. Example:

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

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

Apply fonts to specific elements


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;
}

Adding fonts with custom.css file


While we recommend using the available Custom CSS settings in the theme editor, you can use Eclipse’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.

Applying fonts to specific elements requires knowing how to use your browser's and familiarity with .

Inspector tool ↗
CSS selectors ↗
verified Fluorescent partner
Shopify's Font Picker
CloudConvert
online store speed