What image format should I use for WordPress?

PNG for placeholder images. WordPress handles PNG uploads natively and generates all registered thumbnail sizes from the original. Use JPEG for photographs in production.

How do I handle WordPress hard-crop image sizes?

Generate placeholders at the exact hard-crop dimensions in PlacePack. WordPress will use the uploaded image directly without re-cropping, maintaining the placeholder's label and layout.

Can I use placeholder images in a WordPress block theme?

Yes. Block themes use the same media library and image blocks as classic themes. Upload fixtures to the media library and insert them into block patterns and template parts.

Placeholder Images for WordPress Theme Development

Published March 11, 2026

WordPress themes are built around images — featured images, header backgrounds, widget thumbnails, and gallery blocks. During theme development, these image slots need content to evaluate the layout. Using real photos from Unsplash or Lorem Picsum introduces inconsistency and external dependencies. Placeholder images generated at your theme's exact registered sizes give you a reliable development environment from the first line of code.

Identifying image sizes in your WordPress theme

WordPress themes register custom image sizes via `add_image_size()`. Check your theme's `functions.php` or setup file for registered sizes. Common WordPress image sizes include:

- **Thumbnail**: 150×150 (hard crop) - **Medium**: 300×300 (soft crop) - **Large**: 1024×1024 (soft crop) - **Featured image**: 1200×628 or custom - **Header image**: 1920×600 or custom - **Widget thumbnail**: 400×300

Generate a PlacePack fixture for each registered size. Add the WordPress size name as the label so filenames match.

WordPress image sizes

// functions.php
add_image_size('hero', 1920, 600, true);
add_image_size('card-thumb', 400, 300, true);
add_image_size('featured', 1200, 628, true);

Populating the media library with fixtures

Upload the placeholder images from the PlacePack ZIP into your WordPress media library. WordPress will automatically generate all registered thumbnail sizes from each upload. Use a plugin like WP CLI or Flavor to bulk-import the fixtures.

Alternatively, include the fixture images in your theme's `/assets/images/` directory and reference them directly in template files during development. This bypasses the media library entirely and gives you deterministic output without database dependencies.

Seeding content with WP CLI

For automated theme development workflows, use WP CLI to create posts and attach placeholder images. This is especially useful for theme unit test data — every developer gets the same content and images, so visual reviews are consistent across environments.

Combine PlacePack fixtures with the WordPress Theme Unit Test Data (XML) to create a comprehensive development dataset.

WP CLI seed script

# Import placeholder images
wp media import assets/images/hero_1920x600.png --title="Hero Placeholder"
wp media import assets/images/card_400x300.png --title="Card Placeholder"

# Create a post with the featured image
wp post create --post_title="Sample Post" --post_status=publish
wp post meta update 1 _thumbnail_id 2

Testing responsive themes

WordPress themes must work across desktop, tablet, and mobile viewports. Generate placeholder images at each breakpoint's expected dimensions. Use the WordPress Customizer preview to check layouts at different widths and verify that the placeholder images scale correctly.

The PlacePack label embedded in each image makes it easy to spot sizing issues — if a placeholder labeled `hero / 1920×600` appears at the wrong aspect ratio, you know the CSS needs adjustment.

Theme submission and demo content

WordPress theme directories (like ThemeForest or the official repo) often require demo content. Using professional-looking placeholders instead of stock photos avoids licensing issues and keeps the demo focused on the theme's design rather than specific photo content.

Generate a branded set of placeholders using your theme's primary color palette. This gives the demo a cohesive, intentional look that communicates quality.

FAQ — Frequently asked questions

What image format should I use for WordPress?: PNG for placeholder images. WordPress handles PNG uploads natively and generates all registered thumbnail sizes from the original. Use JPEG for photographs in production.
How do I handle WordPress hard-crop image sizes?: Generate placeholders at the exact hard-crop dimensions in PlacePack. WordPress will use the uploaded image directly without re-cropping, maintaining the placeholder's label and layout.
Can I use placeholder images in a WordPress block theme?: Yes. Block themes use the same media library and image blocks as classic themes. Upload fixtures to the media library and insert them into block patterns and template parts.

Related guides

Ready to generate placeholder images?

Open the generator with the right preset pre-loaded and download your pack in seconds.

Try it in PlacePack →Learn more: PlacePack for Developers