admin-search

JHB Software - Payload Admin Search Plugin

A plugin that adds a global search modal to the Payload CMS admin panel, enabling quick navigation across documents and collections with keyboard shortcuts.

Features

• Global search modal triggered by Cmd + K / Ctrl + K
• Search across collections in your Payload admin panel
• Quickly open collections and globals by name
• Search index powered by @payloadcms/plugin-search
• Real time search results
• Keyboard navigation support
• Configurable search component styles (button or bar)
• Clean, minimal UI

Setup

This plugin requires the official Payload search plugin to be installed. To use this plugin, simply install it and add it to your Payload config.

import { adminSearchPlugin } from '@jhb.software/payload-admin-search'
import { searchPlugin } from '@payloadcms/plugin-search'

export default {
  plugins: [
    adminSearchPlugin({}),
    searchPlugin({
      collections: ['pages', 'posts', 'authors'],
    }),
  ],
}

You can control which collections you can search by adjusting the collections option in the search plugin config.

Configuration

The plugin accepts the following configuration options:

enabled

• Type: boolean
• Default: true

headerSearchComponentStyle

• Type: 'button' | 'bar'
• Default: 'button'
• Description: Choose the style of the search component in the admin header

Button Style (Default)

The default button style shows a compact search button with "Search" text and keyboard shortcut:

adminSearchPlugin({
  headerSearchComponentStyle: 'button', // or omit for default
})

Bar Style

The bar style shows a full search input bar similar to modern search interfaces:

adminSearchPlugin({
  headerSearchComponentStyle: 'bar',
})

Contributing

We welcome contributions! Please open an issue to report bugs or suggest improvements, or submit a pull request with your changes.