# Theme assets Source: https://support.storeconnect.com/articles/theme-assets · Last modified 21 August 2026 Assets are any external resources that a Theme may need, such as images (icons, placeholders, backgrounds, etc.) and files (Javascript, stylesheets). You can add assets to your theme using the Theme Assets object. You can add theme assets from the Related tab of your Theme. ![Theme Assets listed on the Related tab of a Theme record](https://res.cloudinary.com/hzkr6fi81/image/upload/v1725790516/knowledge/themes/theme-assets_gfnwut.png) ![New theme asset form with Key field and file upload](https://res.cloudinary.com/hzkr6fi81/image/upload/v1725790518/knowledge/themes/new-asset_uahtts.png) Once again we have a Key field. This also must be unique per Theme. It can be anything you like, however it is good practice to use a naming convention, eg all images might start with `images/` and be further grouped by type. Here we are uploading a social icon for Twitter, so we have used the key `images/icons/twitter`. ![Saved theme asset record showing the generated URL field](https://res.cloudinary.com/hzkr6fi81/image/upload/v1725790507/knowledge/themes/theme-asset-url_kyk71s.png) Once you have uploaded your file and saved the record, you’ll see that your asset has a URL field. You can use this url in your Theme Templates by copy and pasting that straight into your template. Or even better you can use the liquid filter `asset_url`. You can upload any kind of asset that StoreConnect supports. ## Example Let’s insert a link to Twitter on our home page. Edit the home page template and add the following: ```text Twitter ``` ![Home page template updated with an asset_url link to the Twitter icon](https://res.cloudinary.com/hzkr6fi81/image/upload/v1725790509/knowledge/themes/update-home-page-with-asset_mxytxg.png) Preview the page, and you’ll see we now have a Twitter icon. ![Home page preview displaying the Twitter icon rendered from the theme asset](https://res.cloudinary.com/hzkr6fi81/image/upload/v1725790513/knowledge/themes/preview-home-page-with-asset_s03aov.png) ## Special Assets The built-in StoreConnect theme comes with its own theme javascript and css files. They have been developed to work with our templates - they go hand in hand. You can upload your own Javascript and CSS files and include them in your templates as we showed above. However often you will want them to be included on every page. To do this there are two options: - **Supplements** (`theme-supplement.css` / `theme-supplement.js`) — included automatically after the built-in theme files, so your styles and scripts extend the defaults. - **Replacements** (`theme.css` / `theme.js`) — included automatically in place of the built-in theme files, so the built-in defaults are removed entirely. For the full `{% require %}` tag reference, CSS framework integration (Tailwind/Bootstrap/vanilla), and CSS custom-property overrides, see [Theme assets and styling](theme-assets-and-styling). --- ## Follow StoreConnect - [Email Newsletter](https://getstoreconnect.com/c/lp-newsletter) - [LinkedIn Newsletter](https://www.linkedin.com/build-relation/newsletter-follow?entityUrn=7444956928444862464) - [YouTube](https://www.youtube.com/channel/UCngKdP2x8l1wcbAKW3tvU8g) - [LinkedIn](https://www.linkedin.com/company/storeconnect) - [X / Twitter](https://x.com/storeconnecthq) ## Popular Links - [Partners](https://getstoreconnect.com/partners) - [News](https://getstoreconnect.com/articles/news) - [Events](https://getstoreconnect.com/articles/events) - [Feature Comparison](https://getstoreconnect.com/how-we-compare) - [Download a free trial](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMkeKUAT) - [Book a Demo](https://getstoreconnect.com/contact) ## Documentation - [Help documentation](https://support.storeconnect.com/help-documentation) - [AI agents](https://support.storeconnect.com/ai) - [Videos & tutorials](https://support.storeconnect.com/videos-tutorials) - [Developer reference](https://support.storeconnect.com/developer-reference) - [Release notes](https://support.storeconnect.com/release-notes) - [Troubleshooting](https://support.storeconnect.com/troubleshooting) - [Trust Center](https://trust.getstoreconnect.com/) - [Status Page](https://status.storeconnect.com/) ## Contact - info@getstoreconnect.com - US +1 415 745 3230 - AUS +61 2 8365 2308 100 S Ashley Dr, Suite 600-2461 Tampa FL 33602-600 USA Level 22, Sydney Place 180 George Street Sydney, NSW, 2000, AUS --- StoreConnect Support — https://support.storeconnect.com/articles/theme-assets