Description

The Search Modal Block enhances your WordPress site with a modern, popup search interface that’s both beautiful and functional. Built specifically for the block editor (Gutenberg), it provides a seamless way to add search functionality to any part of your content.

Key Features:

Clean, minimal design that works with any theme
Fully responsive layout
Accessibility-ready with ARIA labels and keyboard navigation
Customizable text elements:
- Search input placeholder
- Search button text
- Screen reader labels
Focus-visible support for better keyboard navigation
Seamless integration with WordPress search

Perfect For:

Minimalist themes needing an elegant search solution
Sites wanting to improve their search UX
Accessibility-focused websites
Any WordPress site using the block editor

Development

This block is built using the WordPress Create Block tool, ensuring compatibility with modern WordPress standards and practices. The source code is available in the plugin’s /src directory.

Building from Source

To build the plugin from source:

Clone the repository
Install dependencies with npm install
Run npm run build to build the production files
For development, use npm run start to start the development server

The build process uses @wordpress/scripts to compile and minify the JavaScript and CSS files. The source code for the compiled files in the /build directory can be found in the /src directory.

Development Dependencies

@wordpress/scripts: ^27.9.0
@wordpress/eslint-plugin: ^21.4.0
@wordpress/stylelint-config: ^21.41.0
eslint: ^8.57.1

The complete source code is available on GitHub: https://github.com/philhoyt/search-modal-block

Credits

This plugin uses the following third-party libraries:

MicroModal – A lightweight, configurable modal library for web applications.

Screenshots

The search modal block in the block editor with customizable settings.
The search modal displayed on the frontend after being triggered by the search icon.

Blocks

This plugin provides 1 block.

Search Modal Block Add an elegant popup search interface to your site with customizable text and accessible design.

Installation

Upload the plugin files to the /wp-content/plugins/ directory, or install the plugin through the WordPress plugins screen directly.
Activate the plugin through the ‘Plugins’ screen in WordPress.
Go to the block editor and search for “Search Modal Block” in the block inserter to add it to your content.

FAQ

How do I customize the search button appearance?: The search button inherits your theme’s colors by default. You can customize its appearance using your theme’s custom CSS or the WordPress site editor.

Reviews

Greg Farries జూన్ 3, 2025

The block appears to be well coded, and it solves the problem I had perfectly. Developer is also responsive, and I look forward to future versions. Thanks!

Read all 1 review

Contributors & Developers

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

philhoyt

Translate “Search Modal Block” into your language.

Interested in development?

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

Changelog

1.1.0

Added ability to upload custom icons for the search button
Added icon size controls with preset sizes (S, M, L, XL) and custom size option

1.0.1

Include assets for .org
Include src for .org

1.0.0

Initial release with search modal block functionality
Customizable placeholder text, button text, and label text
Responsive and accessible design
Integration with WordPress search functionality
Focus-visible support for enhanced keyboard navigation