Help & Support

Last updated: August 31, 2026

Getting started

Iconreport checks which site icons your pages actually serve. No sign-up, no account — just a URL.

  1. Open the App page.
  2. Paste a URL into the input field (e.g. https://example.com). The URL must be publicly reachable.
  3. Click Check or press Enter.
  4. Read the results. The page shows a table of every icon iconreport found declared, each one's status (present / missing / fetch error), detected format, and actual pixel dimensions. A consumer analysis below tells you what a browser tab, a search result, and an iOS home screen would each end up using.

That's it. Results are ephemeral — they disappear when you navigate away or close the tab.

Frequently asked questions

Why is my favicon not showing in Google search results?

Google uses a specific icon for search-result display. The requirements are:

Run your URL through iconreport and look at the Search result consumer card. If it shows "missing", check whether a 48×48+ PNG or multi-size ICO is reachable at the path Google would request.

How do I add an apple-touch-icon for iOS home screen bookmarks?

Add one of these lines inside your page's <head>:

Apple recommends a 180×180 PNG. The icon must be served as image/png over HTTPS. Even without a declaration, iOS will request /apple-touch-icon.png at the site root by convention — so having a file at that path is wise even if you also declare a different path.

iconreport checks both declared and convention paths, so after adding your icon you can verify iOS will find it.

Why does iconreport say my icon is missing, but I can see it in my browser tab?

Browsers cache icons aggressively. What you see in your tab might be a stale icon from the browser's internal cache, served days or months ago. Iconreport bypasses caches entirely — it fetches directly from your server and reports what is served right now.

Another common reason: your page declares an icon path (e.g. /favicon.ico) but a browser visited it before the declaration existed and cached the 404 response. Clear your browser's favicon cache or open an incognito window to see what a first-time visitor gets.

If iconreport still shows "missing" after confirming the file exists on your server, check your server config: does that path return a 200, or is it being rewritten or blocked?

What icon sizes do I actually need?

Iconreport does not give design opinions — it only reports what is served. However, the minimum set that covers most consumers is:

Run iconreport against your homepage to see which of these three actually resolve, and whether each consumer (browser tab, search result, iOS) has an icon to use.

Why can't iconreport check my site? It says “unreachable”.

Some hosts cannot be reached from the runtime iconreport uses. The most common cause is the Cloudflare-to-Cloudflare limitation: when both the checker and the site being checked are behind Cloudflare's proxy network, the runtime cannot open a TCP connection to the site's origin. The checker reports these as unreachable rather than closed.

This affects any URL whose origin is itself served through Cloudflare (including sites like cloudflare.com itself). The limitation is a platform constraint of the Workers runtime, not a bug in iconreport.

For non-Cloudflare hosts, "unreachable" usually means the server is down, blocking the checker's IP range, or has a firewall rule that denies connection.

How do I use the API? Is there programmatic access?

Not yet. An API Access subscription is planned (see the pricing page) but no payment processor is connected and no API keys are being issued. The checkout form on the Pricing page is a demo — it does not take real payment or create an account.

Until the operator connects a payment processor, there is no way to buy API access, no webhooks, no Slack/Discord integration, and no programmatic endpoint beyond the free checker that the app itself uses (which is subject to same-origin restrictions and is not intended for external automation).

Known limitations

Iconreport is a straightforward checker with no persistent infrastructure. The following are honest constraints of what it can and cannot do:

Cloudflare-to-Cloudflare connectivity
The runtime cannot open TCP connections to origins behind Cloudflare. If your site uses Cloudflare, iconreport may report icons as unreachable even when a real browser loads them fine. This is a platform-level limitation and affects every checker hosted on the same runtime, not just iconreport.
No accounts or persistent storage
Results are ephemeral. There is no database, no saved reports, and no way to retrieve a previous check. If you refresh the page, the results are gone. Scheduled or recurring checks are not possible.
No payment system connected
The API Access tier on the Pricing page describes planned features, but no payment processor is wired up. The “Subscribe” button is a demo that shows a success message and nothing else. No money changes hands and no subscription is created.
No email or notifications
Iconreport cannot send email, alerts, digests, or any kind of notification. If you check a URL that later changes, there is no way for the service to tell you. There is no mailbox on this domain.
SVG dimensions
SVG icons do not carry pixel dimensions in their binary header. Iconreport will report “no dims” for SVG files. This is a property of the format, not a bug.

Contact us

No mailbox is available on this domain yet. The operator has not registered a legal entity or provided a contact address. Until that happens, there is no way to reach the operator by email, post, or phone.

If you are the operator and need to configure a support channel:

In the meantime, the app works as described, and the pricing page describes what is planned vs what is available today. No support engineer is on duty.