---
title: Cursor Favicon Install Guide
description: Install a full favicon and app icon set with Cursor: generate the real image files, then have the agent wire the head and manifest to the repo's convention.
canonical: https://favicontools.com/cursor/favicon-install
---

# Cursor Favicon Install Guide

Cursor edits a real repo on your machine, which makes favicons easy in one way and awkward in another. File placement is entirely under your control, but the model cannot draw a PNG — so generate the binaries first and let Cursor do the part it is genuinely good at: wiring the head, the manifest, and the commit.

## Why it matters

- **The agent cannot author binaries** — Ask Cursor to "create favicon.ico" and you get a text placeholder or an inline SVG. Bring real exported files; give the agent the markup job.
- **It already knows your framework** — Cursor has the whole repo in context, so it can tell whether app/icon.png is picked up automatically or whether you need explicit tags in index.html.

## Playbook

1. **Export the set into the repo** — Generate the full kit and unzip it into your static directory — /public for Vite, Remix, and the Next pages router; the app directory for App Router icon conventions.
2. **Prompt with exact filenames** — List the files you added and ask Cursor to reference them following the convention already used in this repo, rather than inventing a new one.
3. **Read the diff before accepting** — The usual failure is a link tag pointing at a filename that was never created. Check every referenced path exists, then commit from the source control panel.

## Checklist

- Add a project rule under .cursor/rules noting that icons are generated assets and must not be recreated by the agent.
- Search the repo for "favicon" afterwards to catch leftover links from the original starter template.
- Confirm the image files are actually staged — a broad ignore rule on binaries will silently leave them out of the commit.

## FAQ

### Can Cursor generate a favicon for me?

Cursor can write every line of markup a favicon needs, but it cannot produce the image bytes, because the model outputs text. Generate the PNG and ICO files with a real tool, drop them in the repo, and use Cursor for the wiring and the commit.

### Where should favicon files live in my repo?

It depends on the framework, and Cursor can tell you by looking. Next.js App Router projects pick up app/icon.png and app/apple-icon.png automatically, while Vite, Remix, and static sites want the files in /public plus explicit link tags in the HTML head.

### Why does the tab still show the old icon after Cursor's edit?

Browsers cache favicons far more aggressively than other assets, and dev servers often serve a stale copy until restarted. Restart the dev server and load the page in a private window before assuming the change failed.