Add a favicon to your website
On this page
A favicon is the small icon that appears in the browser tab next to your site’s title. Set it once on the Store record, and StoreConnect shows it on every page of your storefront and in the browser tab of the point of sale (POS) for that store.
There are two ways to add a favicon. Use the Favicon field unless you need an image hosted outside the media library or custom <link> tag attributes.
Method 1: Set the Favicon field on the Store record
Before you start
- Prepare a square PNG image at least 32 by 32 pixels. StoreConnect resizes it to 16 by 16 and 32 by 32 pixel icons.
- Upload the image to the media library. See uploading media. The Favicon field accepts only media records with a File Type of
image.
Set the favicon
- Open the Store record for your site.
- In the Favicon field, search for and select the media record you uploaded, for example
store-favicon.png. - Click Save.
The favicon now appears in the browser tab on every storefront page for that store and on the POS for that store. If the tab still shows the old icon, reload the page or clear the browser cache, because browsers cache favicons.
:::note
The default theme adds the favicon to the page head. If your theme overrides the layouts/theme template, the layout must output current_store.favicon itself, or the favicon does not appear. See theme layouts and pages for the markup.
:::
Method 2: Add a favicon via the Head Content Block
Use this method if you need to reference an image hosted outside the media library, or if you require custom <link> tag attributes. This method sets the favicon on the storefront only, not on the POS. Use one method or the other, not both, so the browser does not receive two sets of icons.
Step 1: Upload your favicon image
Upload your favicon image to the StoreConnect media library and copy the unique URL from the media record. The URL will look something like this: https://res.cloudinary.com/hzkr6fi81/image/upload/v1627259085/media/favicon.png
Step 2: Insert the favicon link tag into the Head Content Block
Create a Head Content Block if you do not have one already. See adding custom JavaScript, CSS, and head content.
In the Head Content Block, add the following, replacing the URL with your own:
<link rel="icon" href="https://res.cloudinary.com/hzkr6fi81/image/upload/v1627259085/media/favicon.png" type="image/png">
Then set this content block as the HTML Head Content Block on your Store record and save.
Was this article helpful?
Thanks for your feedback! It helps us improve our docs.