> For the complete documentation index, see [llms.txt](https://docs.poweredbybackstage.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.poweredbybackstage.com/guides/adding-a-favicon-to-your-site.md).

# Adding a Favicon to Your Site

A favicon is a small image that is located in the browser tab to the left of a webpage’s title. The image bellow shows the location of a favicon.

<figure><img src="https://2635135911-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9NyC60xfSabdCmQW0heP%2Fuploads%2FHsoZkiF6Lsr23ScCHEn6%2Fimage.png?alt=media&amp;token=af2f2217-d9ac-4e05-8afb-4a1a77949fcc" alt=""><figcaption></figcaption></figure>

First, create the variations of your icon for the favicon. Typically, this is at least three images:

* 16x16px square&#x20;
* 32x32px square
* 152x152px square

Once these are created, upload them to the asset manager on your site, and take note of their image URLs.

To add a favicon to your site in backstage, first go to the Site Detail Page for your site, and click `Settings` in the sidebar. On the Settings page, under `Resources`, click `Add Item`.

<figure><img src="https://2635135911-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9NyC60xfSabdCmQW0heP%2Fuploads%2FpqjNvpdZJPNlqC7iDaAK%2Fimage.png?alt=media&amp;token=b6594e09-bbd0-4d7d-a914-6bebd7981d12" alt=""><figcaption></figcaption></figure>

Select `Type` of your favicon image, enter in the URL of your image in `Resource Path`, and enter the `Attributes` of the image you've entered.&#x20;

For example, for the recommended three icons enter:

| Icon      | Type             | Attributes           |
| --------- | ---------------- | -------------------- |
| 16x16px   | icon             | {"sizes": "16x16"}   |
| 32x32px   | icon             | {"sizes": "32x32"}   |
| 152x152px | apple-touch-icon | {"sizes": "152x152"} |

<figure><img src="https://2635135911-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9NyC60xfSabdCmQW0heP%2Fuploads%2FlXVGVwo7dLXDTJYflAro%2Fimage.png?alt=media&amp;token=8302b411-2629-46d3-90b0-318a7fd8b84e" alt=""><figcaption></figcaption></figure>

When you've added all three, you will then be able to publish you site, and see the favicon.

{% hint style="warning" %}
Note: Favicons are only visible on published sites. Draft mode sites will always display the Backstage favicon.
{% endhint %}

<figure><img src="https://2635135911-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9NyC60xfSabdCmQW0heP%2Fuploads%2FQlT9uRdTjRspxtF2puhM%2Fimage.png?alt=media&amp;token=3889ce9c-a69c-4108-a6aa-2edfa81ffe7f" alt=""><figcaption></figcaption></figure>
