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

  • Select your image (or add a new one from Gutenberg blocks).
  • Select the type of image mask from the block’s settings.
  • If you choose a custom image – click on the Choose mask image button to upload your custom mask.
  • Once you have selected the mask – it will apply to your image.
  • If you choose SVG code – paste your SVG code in the textarea field.
  • Once you have pasted the code – it will apply to your image.
  • You can also apply image masks to gallery’s images.

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

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.
Read all 1 review

Contributors & Developers

“WP Image Mask” is open source software. The following people have contributed to this plugin.

Contributors

“WP Image Mask” has been translated into 3 locales. Thank you to the translators for their contributions.

Translate “WP Image Mask” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

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.