Menu

Custom Themes - Using Assets

As of V.1.3.0, you can upload and use assets (images, fonts, etc.) in your theme.


Uploading assets

To upload assets, open up your theme and select Assets > Add New Asset.



Select the files for your assets and hit Upload.



Once the upload is completed, you'll see the files listed in the Assets folder of your theme.



Once the upload is completed, you'll see the files listed in the Assets folder of your theme. They are now ready to use!



Using assets


To use assets within the html of your theme, use code in the following format:


HTML
{{ 'ASSET NAME' | theme_asset_url }}


For example, for the image I uploaded above, I would use this  to add the image into a page, as shown below

HTML
<img src="{{ 'cute-golden-retriever-happy-puppies.png' | theme_asset_url }}">



Using CSS uploaded as an asset


To use a CSS file that you've uploaded as an asset, add this code into your Header file. 


HTML
<link rel="stylesheet" type="text/css" href="{{ 'ASSET NAME' | theme_asset_url }}">


Example if you've uploaded a stylesheet caled thinkific.css into your Assets folder:


HTML
 <link rel="stylesheet" type="text/css" href="{{ 'thinkific.css' | theme_asset_url }}">



Using font files uploaded as an asset


To be able to use a font file that you've uploaded as an asset, add this code into your Theme CSS:


CSS
@font-face {
    font-family: Define-Font-Name;
    src: url({{ 'ASSET NAME' | theme_asset_url }});
}


Example, if I've uploaded my font and the asset file name is bitter-regular.ttf :


CSS
@font-face {
    font-family: Bitter-Regular;
    src: url({{ 'bitter-regular.ttf' | theme_asset_url }});
}


In Site Builder sites only, you can add your new font into the manifest.json file to make it available in your Site Builder Typography settings. 


Find the "options" key for each font setting, and add your new font there. Be sure that there is a comma between each set of curly brackets.


            {
              "value": "Bitter-Regular",
              "label": "Bitter",
              "group": "Serif"
            }



For more help with custom fonts, you can check out this article here


Important things to note:

The following asset types are supported:

  • text files
  • javascript files
  • css files
  • svg, jpeg, png, tiff, bitmap and gif images
  • ttf, woff, woff2 and eot font files
  • json files


Videos are not supported for a number of reasons, but mostly due to them not being optimized for various devices.


Imported files cannot be > 25 MB


Assets will be overwritten if an asset with the same name is uploaded. Assets can be renamed if necessary, by double-clicking on them in the Assets folder. 


They will also not carry over if you update or change your theme - you will have to re-upload them to your current active Theme and add your code back in.  If you need more help with Custom Themes please see Custom Themes (For Developers).



Related articles:

Need a little extra help customizing or designing your site? We have a wonderful team of experienced freelancers available to give you a hand! Check out our Experts Marketplace





Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.