WP Image Mask

Description

Select a custom mask for your Gutenberg image’s block or add a masked image anywhere via shortcode [wp-image-mask].

Shortcode attributes:

• src – URL of the image;
• mask – URL of the mask;
• fit – how the mask should fit into the image. cover, contain (default contain);
• alt – alt text for the image.

Screenshots

Installation

Upload the WP Image Mask plugin to your site, activate it and start using.

FAQ

Do I need to replace my images with some custom Gutenberg block to use an image mask?

No, this plugin attaches to the native Gutenberg image block, so no need to replace your existing images.

Can I apply my custom image mask?

Sure! You can select a custom image mask file or paste SVG code of your image mask.

I don’t use Gutenberg – is there any other way to add an image with a mask?

Yes! You can use shortcode [wp-image-mask src="https://url_of_your_image" mask="https://url_of_your_mask_image"].

Reviews

Works great

yodergreg December 22, 2023 1 reply

I needed a way to have irregular looking shapes for photos. I thought I might have to create a custom solution, but was pleased that this plugin did exactly what I needed. I was able to upload SVG images to use as masks to the site media library, and then it was really easy to assign those to be used as masks to images using the default WP image block. I like how the plugin integrates directly into the image block interface. Excellent! I will end up using this plugin on a lot more sites in the future.

Contributors & Developers

Changelog

3.1.2

• Removed inline tags, applied image mask as inline css
• Fixed Gutenberg view for custom image mask
• Migrate to @wordpress/create-block

3.1.1

• Removed unnecessary wp-image-mask – CGB Block

3.1

• Add the ability to select mask fit in the Gutenberg block

3.0

• Stable release.
• Add a shortcode to apply image mask.

2.0

• Stable release.
• Fixed issues with applying custom masks to images.
• Add the ability to paste SVG code for image masks.

1.0

• First release.