ScreenshotNeo

BlogHow-to

How to Add a Logo to a Website Thumbnail

Learn how to overlay a logo on any website thumbnail, keep it readable at small sizes, and publish it correctly in WordPress.

By the ScreenshotNeo team30 September 20269 min read

How to Add a Logo to a Website Thumbnail

Direct answer: Add your logo as a separate transparent layer over the thumbnail in an image editor, keep safe padding from the edges, check the result at the size readers will see, then export a flattened PNG or JPEG. In WordPress, upload that finished file as the post’s featured image, or use the Image, Cover, or Site Logo block depending on whether the branding is for one image or the whole site.

1. Prepare the logo and thumbnail assets

Start with the highest-quality logo you have. A transparent PNG is usually the most useful because it preserves the logo’s shape without adding a rectangular background. Keep the original vector or layered file separately so you can change colors, placement, or size later.

  • Use a transparent logo: PNG, SVG, or another format that preserves transparency. Export a PNG for broad editor compatibility.
  • Choose the final thumbnail canvas first: Decide the pixel dimensions required by your site, social network, or CMS before placing the logo.
  • Keep a safe area: Leave visible padding between the logo and every edge. Cropping systems may remove a few pixels on different screens.
  • Protect the subject: Do not cover a face, product, headline, or other information that explains the image.

Do not use the WordPress site-icon minimum of 512 × 512 pixels as a universal thumbnail size. WordPress documents that size for a site icon; article thumbnails and social images can use different dimensions.

2. Add the logo in an image editor

Canva workflow

  1. Create a design using the exact output dimensions you need, or open the existing thumbnail.
  2. Upload the thumbnail and your transparent logo as separate images.
  3. Place the logo on top of the thumbnail as a separate layer.
  4. Resize it until it remains recognizable when the complete image is shown small.
  5. Align it consistently, such as the upper-right or lower-left corner, and keep the same padding for future thumbnails.
  6. Add a subtle backing shape or shadow only when the logo loses contrast against the background.
  7. Preview the design at the actual display size, then export a flattened PNG or JPEG.

Canva’s documented upload and editing workflow supports this overlay model: the background and logo remain separate while you compose, then the exported file becomes one finished thumbnail.

Compose the thumbnail and transparent logo as separate layers, then export one finished image.
Compose the thumbnail and transparent logo as separate layers, then export one finished image.

Any layer-based editor

Photoshop, Affinity Photo, GIMP, and similar editors use the same process:

  1. Open the thumbnail as the bottom layer.
  2. Import the logo above it.
  3. Scale the logo proportionally so it does not become distorted.
  4. Use guides or a grid to keep its offset from the edges consistent.
  5. Check contrast in both light and dark areas of the image.
  6. Save the editable project, then export a web-ready copy.

Keep the editable source. A flattened export is convenient for publishing, but it makes later repositioning harder.

3. Automate logo placement with code

Automation helps when you generate many thumbnails from the same template. The examples below place a transparent logo in the top-right corner with a fixed margin. Adjust the dimensions, margin, and logo width for your brand.

ImageMagick command line

magick thumbnail.jpg logo.png \
  -resize 320x \
  -gravity northeast \
  -geometry +40+40 \
  -composite \
  -quality 88 \
  branded-thumbnail.jpg

The -resize 320x operation scales the logo to 320 pixels wide while preserving its aspect ratio. -gravity northeast selects the top-right corner and -geometry +40+40 adds horizontal and vertical padding.

Python with Pillow

from PIL import Image

thumbnail = Image.open('thumbnail.jpg').convert('RGBA')
logo = Image.open('logo.png').convert('RGBA')

logo_width = 320
logo_height = round(logo.height * logo_width / logo.width)
logo = logo.resize((logo_width, logo_height), Image.Resampling.LANCZOS)

margin = 40
x = thumbnail.width - logo.width - margin
y = margin
thumbnail.alpha_composite(logo, (x, y))
thumbnail.convert('RGB').save('branded-thumbnail.jpg', quality=88, optimize=True)

Install Pillow with python -m pip install Pillow. The alpha composite preserves transparent pixels in the logo. Convert to RGB only when exporting JPEG, because JPEG does not support transparency.

Node.js with sharp

import sharp from 'sharp';

const thumbnail = sharp('thumbnail.jpg');
const metadata = await thumbnail.metadata();
const logoWidth = 320;
const logo = await sharp('logo.png').resize({ width: logoWidth }).png().toBuffer();
const logoMeta = await sharp(logo).metadata();
const margin = 40;

await thumbnail
  .composite([{
    input: logo,
    left: (metadata.width ?? 0) - (logoMeta.width ?? logoWidth) - margin,
    top: margin
  }])
  .jpeg({ quality: 88, mozjpeg: true })
  .toFile('branded-thumbnail.jpg');

Install the dependency with npm install sharp. For a transparent final image, change the output to .png() instead of .jpeg().

4. Choose the right WordPress method

Image block: one composed image

Use the Image block when the logo is already part of a finished thumbnail. Upload the exported file from the Media Library, set meaningful alternative text, and use the editor’s crop or replace controls if needed. This is the simplest option for a one-off article image.

Cover block: background plus overlays

The Cover block combines a background color, image, or video with overlaid content. It is useful when you want to keep the background and branding editable in WordPress, or when the thumbnail includes text layered over the image. Keep the logo as a separate overlay when you need to reposition it without rebuilding the background.

Site Logo block: reusable site identity

Use the Site Logo block for a logo that represents the entire website rather than one article thumbnail. WordPress describes it as a way to add a logo or image representing your website identity and increase brand recognition. Upload or select the logo from the Media Library, resize or crop it, and reuse it across Site Logo blocks.

Classic theme code

Classic themes can register custom-logo support and render the logo with the built-in template function:

add_action('after_setup_theme', function () {
    add_theme_support('custom-logo');
});

function site_brand_mark() {
    if (function_exists('the_custom_logo')) {
        the_custom_logo();
    }
}

Call site_brand_mark() in the template location where the site identity should appear. This is separate from composing a logo into an individual featured image.

Featured image and post thumbnail

Assign the finished branded file as the post’s Featured Image in the editor. In a classic theme, the_post_thumbnail() displays the post thumbnail using a registered size or explicit dimensions:

<?php
if (has_post_thumbnail()) {
    the_post_thumbnail('large', [
        'alt' => get_the_title(),
        'loading' => 'lazy'
    ]);
}
?>

The theme controls which registered image size is generated and displayed. Confirm the crop at the size used in archive cards, the single-post header, and responsive layouts.

5. Make the logo readable at thumbnail size

  • Preview small: Zoom out until the image is approximately the size of a card or social preview. A logo that looks clear on a large canvas may disappear when reduced.
  • Preserve contrast: Place a dark logo on a light area and a light logo on a dark area. A translucent backing plate can help over busy photographs.
  • Use consistent placement: Repeating the same corner and padding builds recognition across a series.
  • Respect safe crops: Keep the logo away from edges where a theme or social platform may crop.
  • Keep proportions: Never stretch the logo horizontally or vertically to fill space.
  • Export appropriately: Use PNG when transparency or crisp edges matter; use JPEG when the image is photographic and a smaller file is more important.

6. Accessibility and metadata checklist

Decide whether the logo adds information or is decorative. If the image communicates the article topic, write alternative text that describes that purpose. If the logo is purely decorative and nearby text already identifies the content, follow your site’s accessibility policy for decorative images.

  • Write alt text for the complete thumbnail, not just the logo, when the image conveys meaning.
  • Do not put essential words only inside the image; they may be unreadable or unavailable to assistive technology.
  • Use the WordPress Image block’s alt-text field after upload.
  • Check the exported file’s dimensions and compression before publishing.
  • Retain the original layered source for future edits.

7. Capture a branded website thumbnail automatically

If your source is a live webpage, you can first capture the page and then apply the overlay in your image pipeline. Your own browser automation can use Playwright or Puppeteer: launch a browser, set the viewport, navigate to the URL, wait for the page to settle, take a screenshot, and composite the logo with ImageMagick, Pillow, or sharp. This gives maximum control, but you must maintain browser binaries, waiting rules, cookie handling, blocked resources, and failure retries.

8. Or skip the browser setup

ScreenshotNeo returns a website screenshot from one GET request and supports PNG, JPEG, WebP, and PDF output. See the ScreenshotNeo API documentation for all 63 options, including full-page capture, CSS selectors, custom CSS and JavaScript, device presets, dark mode, retina scale, waits, request blocking, cookies, headers, geolocation, caching, signed links, asynchronous jobs, bulk capture, and usage reporting.

A clean capture pipeline removes obstructing overlays before the thumbnail is produced.
A clean capture pipeline removes obstructing overlays before the thumbnail is produced.
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp
import requests
r = requests.get("https://api.screenshotneo.com/v1/shot", params={"access_key": "YOUR_API_KEY", "url": "https://stripe.com"}, timeout=90)
open("shot.webp", "wb").write(r.content)
const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://stripe.com' }); const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);

After downloading the image, place your logo with the same Pillow, sharp, or ImageMagick step shown earlier. ScreenshotNeo removes cookie and consent banners, newsletter popups, and chat widgets before capture. Bot checks, blank pages, timeouts, failed loads, and cache hits are not billed; response headers identify the page verdict and whether the shot was billed. Its MCP server lets Claude, Cursor, and other MCP clients use take_screenshot, get_page_info, and capture_pdf. The Free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000 shots. Create a free ScreenshotNeo account.

9. Troubleshooting common problems

Problem Likely cause Fix
Logo has a white box The source file is JPEG or has a solid background. Export a transparent PNG or remove the background before compositing.
Logo is blurry The source is too small or was enlarged heavily. Start with a larger logo, use a vector source, and export at the final pixel dimensions.
Logo disappears on mobile The theme uses a tighter crop or responsive image size. Preview the actual mobile crop and move the logo into the safe area.
Logo has poor contrast The background changes behind it. Move it to a quieter area or add a subtle translucent backing shape.
WordPress shows the old image Browser, CDN, or WordPress image-cache behavior. Use a new filename, regenerate required sizes, and clear relevant caches.
Automated capture includes a popup The browser captured before the overlay or consent state settled. Wait for a selector, delay, or network idle; hide the popup selector or use ScreenshotNeo’s cleanup options.
Screenshot request fails Invalid URL, authentication, timeout, or bot check. Verify the URL encoding and credentials, increase the timeout where supported, inspect the response status and X-Page-Verdict header, and retry transient failures.

10. Performance, reliability, and cost considerations

For a fixed set of thumbnails, precomposed files are fastest to serve because the logo is already flattened. Keep the source image at the required dimensions, compress photographic backgrounds, and avoid repeatedly resizing the same asset on every request.

For generated thumbnails, cache captures by URL, viewport, and configuration. A cache key should include any custom CSS, dark-mode setting, device preset, and logo version. When the logo changes, increment its version so old composites do not remain in circulation.

Browser automation has operational costs: browser startup time, memory usage, dependency updates, network variability, and pages that never finish loading. Use explicit waits and bounded retries. ScreenshotNeo supports a cache TTL you choose, asynchronous jobs with signed webhooks, and bulk capture of up to 100 URLs per call, which can simplify larger batches. Only clean shots are billed, and failed or unusable captures are identified in the response.

11. FAQ

Should the logo be part of the image or an HTML overlay?

Flatten it into the image when the thumbnail must look identical everywhere, including social cards. Use an HTML overlay when the logo needs to remain editable or clickable on the page.

Yes, when your editor or image pipeline supports SVG input. Export a PNG for tools that rasterize uploads or for predictable thumbnail rendering.

Where should a logo go?

Choose a consistent corner with enough contrast and padding. The best location depends on the subject and the crop used by your site.

Does every thumbnail need the same logo size?

Use a consistent visual scale rather than blindly reusing one pixel width. A logo should remain recognizable across portrait, landscape, and narrow card layouts.

WordPress can display a composed featured image through theme code, but automatic compositing requires an image-processing plugin, a build step, or a custom service. Test generated sizes and crops before applying it site-wide.