To use a screenshot as your WordPress site icon, make a square crop at least 512 × 512 pixels, then select it in WordPress’s Site Icon control. The menu depends on your setup: WordPress 6.5 and later has a Site Icon control in General Settings; block themes also offer Appearance → Editor → Identity; classic themes on WordPress 4.3 through 6.4 use Appearance → Customize → Site Identity. WordPress can crop a non-square source during selection.
What a WordPress site icon is—and what a screenshot will look like
The Site Icon is the small image used to identify your site in browser tabs and bookmarks, and in mobile contexts. It is the favicon-like image, not the larger logo shown in your page header. A screenshot can work, but it is usually too detailed to remain legible when reduced to icon size. Crop it to one recognizable subject and remove browser controls, blank margins, or other clutter. That simplification is practical advice for a tiny display, rather than a separate WordPress requirement.
WordPress.org recommends a PNG image at least 512 × 512 pixels. WordPress’s built-in cropper can turn a non-square source into a square icon. WordPress core then creates icon sizes for different contexts, so you generally do not need to make a separate favicon.ico file or edit theme templates. See the WordPress.org Create a Favicon guide and the WP_Site_Icon developer reference.
Choose the right Site Icon screen
| Your setup | Where to set the icon | What to expect |
|---|---|---|
| WordPress 6.5 or later | Settings (sometimes labeled General Settings) > Site Icon | Choose a Site Icon, then select or upload the image. |
| Active block theme | Appearance > Editor > Identity | Click the Site Icon image area. The editor also has Site Title, Tagline, and Site Logo controls. |
| WordPress 4.3 through 6.4 with a classic theme | Appearance > Customize > Site Identity | Choose Select Image under Site Icon; publish the Customizer change. |
Labels can vary slightly by release. The Site Editor’s Identity section is for block themes; if you do not see it, use the Customizer route for a classic theme or check the active theme’s settings. WordPress introduced the Site Icon feature in version 4.3; the current General Settings route is documented for WordPress 6.5 and later. See Create a Favicon, Customize the Site Identity, and Site Logo block.
Recommended Free Tools
#1 Best Overall
Prepare a screenshot that reads well at icon size
- Start with a clear subject. Pick a screenshot detail that remains identifiable when small, such as a distinctive product mark or simple interface element. Avoid trying to preserve an entire page view.
- Crop away distractions. Remove browser chrome, empty space, and unrelated interface elements. Keep the recognizable content near the center so it survives a square crop.
- Make the source square and at least 512 × 512 pixels. PNG is WordPress.org’s recommended format. If the original is rectangular, you can leave the final square crop to WordPress’s picker.
The 512 × 512 minimum and PNG recommendation are from WordPress.org’s current favicon documentation. A larger source is fine, but the important detail should remain visible after the icon is reduced. Do not assume that a detailed desktop screenshot will be readable just because it meets the pixel minimum.
Set the Site Icon in WordPress 6.5 or later
- Sign in to the WordPress administration area with an account that can change site settings.
- Open Settings > General Settings (the menu may appear simply as Settings) and find Site Icon.
- Choose Choose a Site Icon. Select an image from the Media Library, or upload the screenshot when the picker opens.
- If WordPress presents a crop, adjust it to a square that keeps the subject recognizable; confirm the crop.
- Save or update the settings, then inspect the site in a browser tab or bookmark preview.
The precise button wording may vary by release. WordPress.org documents selecting or uploading an icon through General Settings for WordPress 6.5 and later. Because browsers can retain favicon data, a saved change may not appear immediately in a tab that was already open.
Set it through a block theme’s Site Editor
- Go to Appearance > Editor.
- Choose Identity in the Site Editor.
- Click the Site Icon image area, then upload the screenshot or choose it from the Media Library.
- Crop if prompted, keeping the key detail centered, then save the change.
Identity also includes controls for Site Title, Tagline, and Site Logo. The Site Icon is still distinct from the Site Logo: one identifies the site in small browser and app contexts; the other is typically displayed in the page layout.
Set it through the classic Customizer
For a classic theme on WordPress 4.3 through 6.4, open Appearance > Customize > Site Identity. Choose Select Image under Site Icon, upload or choose the screenshot, crop it to a square when prompted, and click Publish. The Customizer route is documented in WordPress.org’s Site Identity guide.
Do these 3 things before closing this tab:
1Clear out junk files and repair common Windows errors2Fix the driver behind crashes, sound loss and screen glitches3Repair Windows errors before they cause bigger problemsUse a Site Logo image as the icon
If the screenshot is already assigned to a Site Logo block and also works as a tiny icon, you may be able to reuse it rather than upload another image. Select the Site Logo block, open its settings, and enable Use as site icon. This makes the logo image the icon shown in browser tabs, bookmark bars, and WordPress mobile apps. The option is documented for the Site Logo block; it is not a general rule that every theme’s logo setting automatically becomes the Site Icon.
Or skip the browser setup
If what you need is a screenshot file to prepare or crop—not a way to bypass WordPress’s Site Icon setting—you can request a screenshot with one API call. Use the returned image as your source, then upload and select it in WordPress as described above. ScreenshotNeo is a website screenshot API and MCP server for developers. Its clean-shot options can accept cookie and consent banners and remove more than 60 known consent platforms, newsletter popups, and chat widgets before capture; each step can be turned off. Bot checks and CAPTCHAs, blank pages, timeouts, failed loads, and cache hits cost nothing, and response headers report the page verdict and billing status. An MCP server exposes screenshot tools to AI agents and MCP clients.
For example, request a WebP screenshot of a page you control or are permitted to capture:
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpSee the ScreenshotNeo API documentation for authentication and request options. The returned image is a screenshot, not automatically a finished WordPress icon: crop it to a square of at least 512 × 512 pixels and check that its detail is legible before uploading. ScreenshotNeo offers 1,000 screenshots per month free with no card; paid plans start at $5 for 3,000 screenshots. Sign up for the free plan.
Free tools Windows power users keep installed
One-click scans. No signup required.
Troubleshoot common Site Icon problems
There is no Identity section in Appearance > Editor
The Identity section described here is available with an active block theme. If the site uses a classic theme, use Appearance > Customize > Site Identity where available. For WordPress 6.5 or later, also check Settings > General Settings > Site Icon. A theme can expose its own settings, so menu availability may differ.
WordPress rejects the image or the crop looks wrong
- Check that the image is at least 512 × 512 pixels and use PNG, WordPress.org’s recommended format.
- If the source is rectangular, accept the crop prompt and choose a square that retains the subject.
- Remove browser controls and large blank margins before retrying; they can leave the actual content too small to recognize.
The old icon still appears
First confirm the setting was saved or, in the Customizer, published. Then reload the page or inspect it in a private browsing window. Browsers may cache favicons; WordPress’s documentation does not promise a specific refresh time.
The page logo changed, but the browser icon did not
A Site Logo is for the page layout, while the Site Icon is for browser tabs, bookmarks, and mobile contexts. Set the Site Icon separately, or use the Site Logo block’s Use as site icon option if you want that same image in both places.
Check the result in the places visitors use it
After saving, inspect the icon in a browser tab and, if relevant, a bookmark preview. Also consider how the image reads at small sizes: an icon that looks clear in the Media Library can become indistinct when reduced. If it does, return to the source image and crop around a simpler, more recognizable element rather than enlarging or adding detail.
Frequently Asked Questions
Do I need to create a favicon.ico file for WordPress?
Usually not. WordPress’s Site Icon feature generates icon sizes for different contexts, so a separate favicon.ico file or manual theme-template edit is normally unnecessary.
Can I use the same image for my Site Logo and Site Icon?
Yes, when using the Site Logo block, enable “Use as site icon” in that block’s settings. A Site Logo does not automatically serve as the icon in every theme.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
