Description
Photo Block is an advanced yet intuitive responsive image block plugin for WordPress that makes adding, styling, cropping, and managing photos inside the block editor a breeze.
Quick Links:
🏠 Plugin Home | 📗 Documentation | 🙏 Support | 🤓 Source Code
❤️ Spin up a Free Demo ❤️
Photo Block combines many features from other image blocks into one, resulting in a fully featured alternative that includes responsive controls,easy cropping, global styles, caption overlays, and lightbox support.
Whether creating a blog, recipe, portfolio, tutorial, or building a site, Photo Block provides you with complete visual control while maintaining speed, responsiveness, and accessibility.
Photo Block was designed for anyone who needs a better way to display images, such as photographers, designers, agencies, and bloggers who want to stand out with polished, on-brand visuals without needing to touch code. With Global Styles, you can maintain a consistent brand look and feel, ensuring all images adhere to a similar visual style.
Key Features
- Easy and Flexible Uploading
Upload directly, choose from the Media Library, or import via a URL. Supports external image sources, such as ScreenshotOne, for automatic screenshots. Every image uploads quickly and previews instantly. - Smart Cropping and Custom Ratios
Define image proportions with built-in ratio presets or enter your own. The smart cropper respects hard crops and presets, such as a known aspect ratio, or you can perform a completely custom crop. - Responsive Image Settings
Every dimension, including padding, width, height, margins, and borders, has responsive controls. Adjust your images to ensure they scale beautifully across desktop, tablet, and mobile devices. - Advanced Sizing, Aspect Ratio, and Object Fit
Fine-tune image width, height, and object-fit for a consistent layout. Set an aspect ratio for a custom fit. This is ideal for creating hero images, grids, and feature sections with pixel-perfect alignment. - Multi-Line and Overlay Captions
Add expressive, multi-line captions or display them as overlays with hover effects. Position captions at the top, bottom, or center, and mix typography blocks for creative layouts. - Built-In Lightbox
Enable a responsive lightbox with just a few clicks by opening link settings. Viewers can expand and browse larger versions of your images without leaving the page. - CSS Gram Filters
Quickly style your images with 26 built-in CSS Gram filters. Adjust warmth, contrast, or add vintage flair directly in the editor without having to use photo editing software. - Drop Shadow Support
Add depth with customizable drop shadows. A subtle toggle turns flat images into elegant, layered visuals. - Global Style Presets
Save your favorite image settings as Global Styles. Apply them anywhere with a single click and update them site-wide later for consistent branding and appearance. - Query Loop Integration
Use Photo Block within the Query Loop block as a featured image source. Captions and settings pull automatically, making it perfect for archives and blog lists. The plugin works well inside a GenerateBlocks or Kadence loop, and also supports the Core Query block.
Why Choose Photo Block
Photo Block was built for creators who outgrow the default image block, but don’t want a bloated gallery plugin or block suite. With intuitive uploading and global styles, you can go from uploaded to published in less than 4 clicks.
This image block blends powerful design tools with a lightweight, intuitive interface that feels like part of WordPress itself.
- Native to the block editor. No nags or shortcodes — everything happens inline.
- Truly responsive. Adjust image presentation for every device size.
- Reusable and Global styles. Choose a global style to keep images on brand and consistent.
- No upsells or limits. Photo Block is 100% free and open source.
- Accessible. Fully supports captions, alt text, and semantic markup.
- Future-proof. The plugin is built with the latest block techniques and architecture and is continuously updated.
If you’ve been searching for a better Gutenberg image block, Photo Block delivers a professional image presentation toolkit without complexity or cost.
Use Cases
- Photography portfolios: Crop and style high-resolution photos with lightbox support.
- Blogs and articles: Add responsive, branded images with consistent captions.
- Business websites: Maintain uniform image styling using global presets.
- Online magazines: Ensure consistent styling using Global Styles across the entire site.
- Site builders: Photo Block can assist with page or site building, acting as a logo source, hero image, and even decorative images.
Photo Block adapts to virtually any WordPress design scenario, offering both creative freedom and practical control.
Technical Highlights
- Uploader: Media Library, drag-and-drop, remote URL uploads, and ScreenshotOne support.
- Cropping: Smart cropper with presets or custom aspect ratios.
- Responsive Controls: Device-specific padding, margin, and border adjustments.
- Sizing Options: Adjustable width, max width, height, max height, and object-fit per device.
- Caption System: Multi-line, block-based, and overlay caption styles.
- Lightbox: Optional responsive lightbox with custom caption support.
- Filters: CSS Gram effects (26 available presets).
- Shadows: Toggle drop shadows for visual depth and 3D-looking images.
- Global Styles: Save and reuse configurations site-wide.
- Query Loop Ready: Works as a featured image block source.
- Accessibility: Encourages alt text and uses semantic markup.
❤️ Spin up a Free Demo ❤️
Development:
Development happens on GitHub. Check out the GitHub code repository for Photo Block.
To assist or help this plugin financially, please consider a GitHub sponsorship.
Libraries and Credits
- Filepond – React Image uploader.
- CSSgram – CSS Image Effects.
- Lucide – React Icon Library.
- React Image Crop – React Image Cropper.
- React Hook Form – React Forms.
- Fancybox – Lightbox Library.
Screenshots

Adding a photo with Photo Block is easy in the block editor. 
Crop, replace, and adjust the accessibility options for your photo. 
Select a global style, adjust the images’s title and alt attributes, sand select the image size. 
Adjust the image’s background color, opacity, blur, and drop shadow. 
Select form 26 different CSS styles using CSS Gram. 
Adjust the padding, margin, and border of the photo. 
Set sizing for the photo, and set the object fit (if desired). 
Set the caption overlay’s positio, and enable an overlay on hover. 
Set the overlay type to None, Solid, Gradient, or Image. 
Set the caption’s typography, background color, and text color. 
Set the caption’s padding, margin, and border. 
Set the caption’s sizing using available block options. 
Global Styles panel, which allows you to save and edit global styles. 
Save or overwrite a global style using the Global Styles modal.
Blocks
This plugin provides 2 blocks.
- Photo Block An easy-to-use and comprehensive image block.
- Caption Block A comprehensive caption block.
Installation
- Search for “Photo Block” on the Add Plugins screen in WordPress.
- Install and activate the plugin from your admin dashboard.
- Once activated, use the block in any page or post by adding “Photo Block” from the block selector.
- Add a Photo Block in your post or page.
- Upload an image or paste an image URL.
- Crop and adjust using the custom ratio cropper.
- Configure styling: margins, borders, shadows, or filters.
- Add a caption: standard or overlay mode.
- Save as a Global Style to reuse later.
- Enable Lightbox for interactive viewing.
- Publish and enjoy a responsive, beautifully styled image.
In-depth Documentation – Please check out our thorough documentation ❤️️
FAQ
-
Do you have a demo?
-
Yes. Spin up a free demo via InstaWP (no email or login required).
-
Can I use Photo Block alongside the default Image block?
-
Yes. Photo Block is completely independent and can be used alongside the default WordPress Image block.
-
Does Photo Block work with the Query Loop block?
-
Yes. It’s fully compatible and can be used as a featured image block within dynamic loops.
-
Is Photo Block mobile-friendly?
-
Absolutely. All dimension controls include responsive breakpoints, ensuring the best presentation on all devices.
-
How does this block differ from the core image block?
-
Photo Block offers more advanced customization options like responsive layouts, a fully-featurd caption, caption overlays, and the ability to reuse styles across multiple blocks using global styles. It’s built for power users who want more control over their image presentation.
Please see the Photo Block documentation for a full list of features.
-
How do Global Styles work?
-
You can save your Photo Block’s current configuration as a global style and reapply it anywhere. Updating a global style automatically updates every image using it.
-
Can I add captions or overlay text?
-
Yes. Captions can be standard, multi-line, or overlayed on the image with optional hover animations. Captions can be positioned toward the top or bottom of the image, or as an overlay. Advanced options allow you to create multi-line captions with blocks of your choice.
-
Does Photo Block include a lightbox?
-
Yes. The block has an integrated lightbox option that displays images in a responsive popup. The lightbox supports captions, and even custom captions.
-
Are CSS filters supported?
-
Yes. You can choose from 26 CSS Gram filter presets directly in the editor.
-
Can I control margins and spacing?
-
Yes. Every spacing control (margin, padding, border) includes desktop, tablet, and mobile options.
-
Does it work with Full Site Editing?
-
Yes. Photo Block is compatible with FSE templates and custom block patterns.
-
Does this work with data?
-
Photo Block works within the Query Loop block as a featured image.
As of release, it is compatible with:
- Core Query Block
- GenerateBlocks Query Loop
- Kadence Query Loop
If you have a specific block suite query loop you’d like to see Photo Block integrated with, please let us know!
-
Does this work with the Classic Editor?
-
No, this plugin is specifically built for the block editor.
-
How can I get help?
-
Please leave a detailed note on our support page.
-
Are you planning on integrating with other services?
-
Yes, we are planning on integrating with other services in the future depending on this block’s popularity and usage.
-
Not at this time.
-
I have a feature request.
-
Please leave a detailed note on our support page.
-
Where do I report security bugs found in this plugin?
-
Please report security bugs found in the source code of the undefined plugin through the Patchstack Vulnerability Disclosure Program. The Patchstack team will assist you with verification, CVE assignment, and notify the developers of this plugin.
Reviews
Contributors & Developers
“Photo Block – A Better Responsive Image Block With Lightbox and Caption Support” is open source software. The following people have contributed to this plugin.
ContributorsInterested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.5.1
- Released 2025-11-16
- Bug fix: global styles would error out or not work if in a query loop.
1.5.0
- Released 2025-11-15
- Updating block.json to version 3, so that the block will now load properly in an iframe editor.
- Updating Filepond scripts and creating custom loader for iframe compatibility.
1.4.0
- Released 2025-09-23
- Global Style fix: Media Link Type and Image Size are stored in global styles again, allowing per-block overrides. This makes it much quicker to add an image, set the global style, and only override if needed.
- UX Fix: Media Library goes straight to upload unless there is an existing image.
- New feature: Page title is added to ScreenshotOne-generated images.
- New feature: Cropping an image also copies its alt and caption attributes.
- UX Fix: Auto-selecting the caption is disabled and doesn’t actually save time in practice. Captions are still auto-selected if a global style supports captions.
1.3.10
- Released 2025-08-03
- Bug fix: Object caching resulted in global styles saving/rendering correctly. This has been resolved.
- Bug fix: Global styles wouldn’t take priority in frontend styles.
- New feature: You can give images a group slug so that they are popped up as a gallery in a lightbox.
1.3.0
- Released 2025-07-31
- New feature: Cropping now pops up in a modal, giving much more room to crop/edit the photo. This solves a bug where cropping in smaller screens or columns would cause the layout to warp.
- Bug fix: Cropping has been fixed for tall photos.
- Bug fix: Duplicate cache keys were causing global styles to error.
1.2.11
- Released 2025-05-27
- ⭐️ Please Rate the Plugin ❤️ to help spread the word and encourage future development.
- Bug fix: Setting block defaults for Photos and Captions. This will make generating and setting styles more reliable.
- Bug fix: Errors in global style generation will now be visible.
- Bug fix: Popover states in the block toolbar refused to close.
1.2.8
- Released 2025-05-24
- Bug fix: Replacing an existing image with a caption from the media library adds a second caption.
- Bug fix: Enter on non-multiline caption should proceed to next block or select the parent photo block.
- Bug fix: Make sure transferring from image block to photo block brings along caption.
- Bug fix/Feature: Allow all blocks within multi-line captions.
- Bug fix: Prevent captions from duplicating.
- Bug fix: Single-line captions should select parent block on Enter keypress.
- New feature: Consolidate image alignment options to free up some space in the block toolbar.
- New feature: Concolidate caption toolbar options to free up space.
- New feature: Provide a “Back to Caption” button when in caption multiline mode with child blocks.
- New feature: Provide a “Back to Photo” button in the caption block.
1.2.5
- Released 2025-05-18
- New Feature: Set aspect ratio per responsive breakpoint.
- New Feature: Image size and a Copy shortcut show next to the image URL field in the sidebar.
- Bug fix: Background color, drop shadow color weren’t honoring opacity.
- Bug fix: Selecting a color with a CSS variable will now properly reflect the color in the block editor.
- Bug fix: Drop shadows weren’t working with feautred images.
- Bug fix: Lazy loading wasn’t honoring settings.
1.2.0
- Released 2025-05-09
- New Feature: Custom links can now pop-up into lightboxes if they are of type jpg, jpeg, gif, png, webp, or avif.
- New Feature: Added Debug mode, which will make the hidden Global Styles post type visiible for inspecting.
- Bug fix: Global Styles would sometimes save the wrong block information, causing a fatal error.
- Bug fix: Fixed Featured Image so that it can be set as a post permalink (this wasn’t saving before).
1.1.5
- Released 2025-05-07
- New feature: Ability to hide the caption text in overlays. This can be used to create advanced effects.
- New feature: Overlay select boxes have been replaced with more compact ButtonGroup components.
- New feature: Now works in GenerateBlocks 2.0 query loops.
- New Feature: Added in transforms to the regular Image block.
- Bug fix: Exclude per-device hide behavior from saving in Global Styles.
- Bug fix: Fixed ScreenshotOne icon during the initial view.
1.1.1
- Released 2025-05-07
- There were a few critical errors when requesting a new ScreenshotOne image.
1.1.0
- Released 2025-05-05
- New feature: ScreenshotOne compatibility released. You can now take website screenshots from within Photo Block.
- New feature: New admin panel to set block and ScreenshotOne defaults.
- New feature: Disable the caption appender by default.
- New feature: File size and URL is shown in the sidebar when available.
- Bug fix: Opacity wasn’t rendering on the frontend.
1.0.14
- Released 2025-01-07
- Bug fix: Uploading in smaller columns didn’t show a preview.
- Bug fix: Cropping was causing a larger view area when loading an image.
- Bug fix: Block icon previews were not displaying properly on .org.
1.0.7
- Released 2024-12-25
- Hot fix: Fix applied in 1.0.5 for fixing copying made images in URL mode upon rendering.
1.0.5
- Released 2024-12-25
- Bug fix: Fixing issue with units not displaying on the frontend or in the block editor.
- Bug fix: Fixing issue with global styles not applying to the iframe when viewing a block as tablet or mobile in the block editor.
- Bug fix: Copying an image from site to site was not working, so a check was added in to make sure the image mode is set to URL if an image ID isn’t found.
1.0.1
- Released 2024-11-03
- Ensuring compatibility with WP 6.7.
1.0.0
- Initial release.
