# Favicon

To use a custom favicon, add a favicon file to the root of your `docs` directory.

Examples:

- `docs/favicon.ico`
- `docs/favicon.png`
- `docs/favicon.webp`
- `docs/favicon.svg`
- `docs/favicon.jpg`
- `docs/favicon.jpeg`

## Rules

- The file must be in the root of `docs`.
- The file must be named `favicon`.
- The file must use one of these file types: `.ico`, `.png`, `.webp`, `.svg`, `.jpg`, or `.jpeg`.

If you do not add a custom favicon, Doctopus uses the default favicon.

## Browser Support

In most browsers, favicons work best as `.ico`, `.svg`, or `.png`.

If you use `.webp`, `.jpg`, or `.jpeg`, Doctopus converts the image to PNG during the build so it works in all browsers.