WordPress setup
Add SearchCue to WordPress
Goal of this tutorial
This guide shows how to install the SearchCue WordPress plugin, connect it to a SearchCue site, and add a search entry point to your WordPress theme.
If you are not using WordPress, use the general setup guide instead.
Before you start
You will need:
- administrator access to your WordPress site
- a SearchCue account
- the SearchCue site ID for the site you want to connect
If you have not added the site in SearchCue yet, sign in, create the site, and copy the site_... value from the setup instructions. That value is what the WordPress plugin calls the SearchCue site ID.
Install the plugin
- Download the plugin ZIP: searchcue.zip.
- In WordPress admin, open Plugins -> Add New -> Upload Plugin.
- Choose the
searchcue.zipfile. - Click Install Now.
- Click Activate Plugin.
Configure the plugin
- Enter your email address and click "Try SearchCue for free".
- Click the link you just received via email and click "Connect WordPress site".
- Finally, click "Finish setup".
The plugin adds the SearchCue embed script to public WordPress pages. It does not change your published content or theme files.
Add a search entry point
SearchCue opens when a visitor follows a link to /search. The simplest setup is to add a menu item with that URL:
- In WordPress admin, open Appearance -> Editor or Appearance -> Menus, depending on your theme.
- Add a custom link.
- Set the URL to
/search. - Use a label such as
Search. - Save the menu or template.
The plugin also detects search input fields on the page and attaches the SearchCue search experience to them. If your theme already has a search input, test it after saving the plugin settings.
Test the setup
Open the public site in a fresh browser tab and click the /search link or focus a search field. The SearchCue interface should open.
If it does not open:
- confirm the plugin is active
- confirm the Enabled checkbox is checked
- confirm the SearchCue site ID starts with
site_ - clear any page cache or CDN cache on the WordPress site
- check that the public page includes
wp_head()
Next steps
After the plugin is connected, open the SearchCue app to trigger a crawl, check indexed pages, and adjust the design.
You can update colors, typography, spacing, and result layout from the Design section without changing the WordPress plugin.