Modal Guten Block


This project provides a modal / popup block for the WordPress Gutenberg editor.

  • Multiple methods for triggering modal including button, text link, image link, external class, and page load.
  • User definable modal content using Gutenberg blocks, for example, image, paragraph etc.
  • Support for multiple modal window sizes.
  • Modal window transitions for fade, left, right, up down.
  • Manual trigger modal initialization by calling bodModal.initModal()
  • Custom events for before open, after open, before close, after close so custom code can be used.
  • Lots of customizable options including Trigger Button Label, Button Color, Trigger Text, Trigger Text Size, Trigger Image, Trigger Class, Modal Delay, Trigger Element Alignment, Overlay Background Color, Title Text Size, Title Font Color, Title Background Color, Title Padding, Border Radius.
  • Supports multiple modals on the same page.
  • ADA compliant.
  • Modal to modal links.
  • Multiple ways to close the modal.
    • Escape key
    • Close button ‘X’ in the top right of the screen.
    • Close button ‘X’ in the modal title.
    • Close button at the bottom on the modal content.
  • Uses create-guton-block for easy config.


If you like the plugin, consider a donation to support further development. Click here


  • Sample modal window.
  • Modal Guten Block in editor.


This plugin provides 1 block.

  • Modal Guten Block


From your WordPress dashboard

  1. Visit Plugins > Add New
  2. Search for “Modal Block”
  3. Install the “Modal Block” plugin
  4. Activate “Modal Block” from your Plugins page
  5. Insert Block on your Gutenberg Editor and select “Modal Block” which is located in Widgets.


སྤྱི་ཟླ་བདུན་པ། 13, 2023
Thank you,Very nice plugin
སྤྱི་ཟླ་གཉིས་པ། 26, 2023
Best PopUp - Plugin! Easy to use! Please write an PopUp - Plugin in this way! Maybe with Exit Intent - Functionality
སྤྱི་ཟླ་དང་པ། 24, 2023
I think everything is almost perfect, it would be great if "everything was a little more clean and polished". Silly things like: add hover color change when focusing edit fields (hard to tell how big the field is) -- for example the "block-editor-plain-text" input field should have more padding, square matching border radius and better font matching size Missing option to "disable transition" visual effect
སྤྱི་ཟླ་དང་པ། 2, 2023 1 reply
What a great little plugin for modals. It is very simple to use and features many ways to use and display them. I was looking at an expensive theme addon that did all of this, but this one does it all FREE, thank you.Would make it complete if it had options to; Set to display after x time Fade in/out Have an exit modal But other than that it is fully functional for everything else.
སྤྱི་ཟླ་བཅུ་པ། 12, 2022
This is such a great plugin. So easy to set up with so many options. Makes pop-ups a breeze!
སྤྱི་ཟླ་བཞི་པ། 1, 2022
Practical and lightweight plugin. Well integrated. Good job. It would be nice to improve the interface for customization especially for the button. And a X button for closing at the top would be great. In general it works fine.
Read all 17 reviews

Contributors & Developers

“Modal Guten Block” is open source software. The following people have contributed to this plugin.


Translate “Modal Guten Block” into your language.

Interested in development?

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



  • Transition effects (fade, left, right, up, down) and ‘Custom Events’ for before modal open, after open, before close, after close
  • Manual trigger modal initialization by calling bodModal.initModal()


  • Modal background images. Separate options into Trigger, Modal, Title and Content panels. Title close X ability to define size. Trigger based on URL text.


  • modal to modal links, text align title, title close button


  • Option to disable close modal on Escape key press.


  • Fixed issue where clicking on nested content in edit mode resulted in modal edit content box closing.
  • When modal opened focus on first element but do not scroll to it. Stops modal opening at bottom.


  • Fix for when we trigger on image and image is smaller than medium size. In this case we default in the full size image.


  • Make ADA compliant including using button instead of span, setting / returning focus and focus trapping.
  • Add custom class to dialog when modal opens.
  • Add toggle option to disable close on overlay click.


  • Optional display only once for timer based modals. Modal Id links timer modals on different pages to say they are the same. Also ability to say how long before modal is shown again.


  • Change icon to use SVG – use alt tag from trigger image – optional close btn in modal


  • Update for deprecated wp.editor (changed to wp.blockEditor) and core/editor (changed to core/block-editor).

1.0.0 (8/19/2019)

  • First release