How to Install QueryPress: Step-by-Step Guide

In this guide you install QueryPress and get your first search up and running, step by step and with images. You don’t need to know how to code: if you can install a WordPress plugin, you already know the main part. At the end you’ll find an explanation of every option.

About the screenshots: they were taken on a WordPress site in Spanish. If your WordPress is in English, QueryPress shows every screen in English, and this guide uses the English names of each option.

Looking for QueryPress Pro? Pro is an add-on and needs this free plugin installed and activated: it doesn’t work without it. Follow this guide first and, at the end, the If you have QueryPress Pro section explains how to install Pro.

1

Install and activate the plugin

First download the file querypress-0.2.0.zip. Don’t unzip it: WordPress installs it as it is.

  1. In your WordPress dashboard go to Plugins → Add New.
  2. Click the Upload Plugin button at the top of the page.
Plugins, Add New screen with the Upload Plugin button
Plugins → Add New → Upload Plugin
  1. Click Choose File and select querypress-0.2.0.zip.
  2. Click Install Now and wait a few seconds.
  3. When it finishes, click Activate Plugin.
Uploading the QueryPress zip file and clicking Install Now
Choose the file and click “Install Now”

Requirements: WordPress 6.0 or later and PHP 7.4 or later. Almost any current hosting meets them.

Once activated, a new item called QueryPress, with a magnifying glass, appears in your dashboard’s side menu. It has five sections:

WordPress side menu with the QueryPress item and its sections
The QueryPress menu in your admin dashboard
SectionWhat it is for
FieldsYou define what data each record has (price, city, brand…).
RecordsWhere you create and edit what people can search for: businesses, products, properties…
CategoriesTo group your records.
SettingsThe URL of your records, their names, how many results per page and more.
Search indexThe status of the search and a tool to repair it if ever needed.
3

Create your fields

Fields are the data each record will have. For a business directory, your fields might be City, Type and Average price. For a catalog, Brand, Model and Price.

Go to QueryPress → Fields and fill in the Add new field form:

Form to add a custom field in QueryPress
The form to create a field
OptionWhat it means
LabelThe name people will see, for example “City”. It is the only required option.
Key (slug)The internal name of the field. It is optional: if you leave it empty, it is created from the label (“Phone” becomes phone). It can’t be changed later.
Field typeText for words (city, brand…) or Number for amounts (price, size…). It can’t be changed later either, so choose carefully.
PrefixOptional. A symbol shown before the value, for example $.
SuffixOptional. What is shown after the value: €, sq ft, miles… Large numbers are shown with a thousands separator, following your WordPress language.
SearchableThe text in this field is taken into account when someone types in the search box.
FilterableCreates an automatic filter in the search (explained just below).
Show in the results cardThe value appears on each result’s card.

How a field becomes a filter

  • A filterable Number field creates two boxes, Min. and Max., with the lowest and highest values as a hint.
  • A filterable Text field with few different values (up to 50) creates a dropdown with those values.
  • A filterable Text field with many different values creates a text box.

When you’re done, click Save field. Your fields appear in the Existing fields table, where you can edit or delete them.

Important: when editing a field you can change its label, prefix, suffix and checkboxes, but not its key or type. If you delete a field, the values already saved in your records are not deleted: they just stop being shown.

4

Create your categories

Categories group your records (for example “Bars”, “Restaurants” or “Apartments”). Go to QueryPress → Categories, type the name and click Add New Category.

QueryPress categories screen
Create the categories for your records
  • You can create categories inside others with “Parent Category”. For example, “Bars” inside “Businesses”.
  • The slug is the lowercase version of the name, without accents. You’ll use it if you want a search that only shows one category.
  • The search shows a Category dropdown with the categories that have records.

Categories are optional: if your directory is simple, you don’t have to use them.

5

Add your records

A record is each thing you want people to find: a business, a product, an apartment… Go to QueryPress → Records → Add New Record.

QueryPress record editor with its fields
Editing a record: title, description and its data
  1. Write the title. It is what appears on the card and the most important part for search.
  2. Write a description if you like. It is shown on the record’s page.
  3. Fill in the Record details panel with the fields you created: city, type, price…
  4. Tick its category.
  5. If you want, add a featured image: it will appear at the top of the card.
  6. Click Publish.

About images: landscape photos work best, around 1200 × 750 pixels and lightweight (under 150 KB). Records without an image are shown the same way, just without a photo.

Each record also has its own page, with a details table and a “← Back to results” link.

6

Review the settings

In QueryPress → Settings you adapt the plugin to your site. The defaults work well, so you can leave them and come back later.

QueryPress settings screen
QueryPress basic settings
SettingWhat it does
URL baseThe word before each record’s name in its address. The default is directory, which looks like this: yoursite.com/directory/record-name/. You can use whatever you prefer, for example businesses or products.
Name of one recordWhat you call each item: “Business”, “Product”, “Property”. It changes the texts in the dashboard.
Name of all recordsThe same in plural: “Businesses”, “Products”, “Properties”.
Results per pageHow many cards are shown before moving to the next page, from 1 to 100. With 9 or 12, rows stay complete on wide screens.
Results pageOptional. Where a record’s “Back to results” link goes when the visitor arrives from outside your site, for example from Google.
UninstallIf you tick it, deleting the plugin also deletes your fields, settings and records. Leave it unticked if you want to keep your data.

Careful: if you change the URL base once your site is live, your records’ addresses change. If Google already knows them, you will need to set up redirects.

7

Create the search page

Now it’s time to show the search to your visitors. Create a new page (Pages → Add New), give it any title and add a Shortcode block. Inside, type:

[querypress]
WordPress page with the QueryPress shortcode block
A page with the shortcode block

Click Publish and open the page. Your search is up and running.

Tip: if instead of the search you see the text [querypress] written on the page, the block is not a “Shortcode” block. Change it to that block type.

8

See the result

This is what your visitors will see. If records have a featured image, the card shows it at the top. If not, it appears without an image. You choose.

QueryPress search results, with or without images depending on the record
The results, with or without images as you choose
QueryPress variants
QueryPress variants

How search works

  • As you type. Results update on their own, without clicking anything or reloading the page.
  • Accents and capitals don’t matter. “cafe” finds “Café”.
  • From the beginning of the word. “mad” finds “Madrid”.
  • Every word counts. “bar madrid” looks for records that contain both.
  • Filters (dropdowns, ranges and category) apply instantly and combine with each other and with the text.
  • Pages. If there are more results than fit, pagination appears below.
  • If there is nothing to show, you’ll see “No results found.”

The browser’s Back button works as expected: you return to the search with its filters.

9

The search index

To keep search fast even with thousands of records, QueryPress keeps its own search index. It updates automatically every time you publish, edit, delete or trash a record, or when you change which fields are searchable or filterable. Normally you won’t need to do anything.

QueryPress Search index screen with the status Ready
QueryPress → Search index

On this screen you see the State (it should say “Ready”), the Search method, how many records are published and how many are in the index. Those two numbers should match.

Click Rebuild index if:

  • you imported records directly into the database,
  • you restored a backup,
  • or the search results are not what you expect.

You’ll see a progress bar. Your records and fields are never modified.

Shortcode options

The basic shortcode [querypress] shows all your records. You can adjust it with these options:

OptionWhat it doesExample
per_pageHow many results per page, for this search only.[querypress per_page="12"]
categoryShows only the records in one category. Use its slug; for several, separate them with commas. Filters are calculated with that category only.[querypress category="businesses"]
show_filtersno hides every filter and leaves only the search box.[querypress show_filters="no"]
show_category_filterno hides only the category dropdown.[querypress show_category_filter="no"]

You can combine them, and you can have several searches on the same site, each on its own page and with its own category:

[querypress category="products" per_page="12" show_category_filter="no"]

If you have QueryPress Pro

Very important: QueryPress Pro doesn’t work on its own. It is an add-on that needs the free QueryPress plugin installed and activated. If you install only Pro, it will tell you the free plugin is missing and won’t activate.

The right order is always the same:

  1. Install and activate the free plugin following the steps in this guide. If you don’t have it yet, download it here.
  2. Install Pro. After buying you receive an email with your license key and a link to download the plugin. Go to Plugins → Add New → Upload Plugin, upload the Pro .zip file and click Activate Plugin.
  3. Paste your license key when asked.
  4. Choose your design in QueryPress → Design: palette, layout and shape, with a live preview. Save and you’re done.

Pro never modifies your fields or records: it only adds design and the new field types. If you want a different layout on a specific search, add layout to the shortcode, for example [querypress layout="rows"] (possible values: cards, list, compact and rows).

Want to see what it includes, examples and pricing? Visit the QueryPress Pro page.

Frequently asked questions

A record doesn’t appear in the search

Check that it is published (not a draft). Then go to QueryPress → Search index: if records are missing, click Rebuild index.

A field doesn’t appear in the filters

Edit the field in QueryPress → Fields and tick Filterable. If it is a text field, some record must have a value saved in it for the dropdown to be created.

A value doesn’t appear on the card

Edit the field and tick Show in the results card. Fields that are empty in a record are not shown.

I change a setting and don’t see the change on my site

If you use a caching plugin, purge the cache and reload the page.

Can I rename “Records”?

Yes. In Settings, change “Name of one record” and “Name of all records” to whatever you prefer.

What happens to my data if I delete the plugin?

Nothing, unless you ticked the option to delete it in Settings → Uninstall. If you reinstall it, you get everything back.

Is it available in other languages?

QueryPress is available in English and Spanish. It is shown in the language of your WordPress site.

Can I install only QueryPress Pro?

No. QueryPress Pro is an add-on and needs the free QueryPress plugin installed and activated. Install the free plugin first, following this guide, and then Pro, as explained in the If you have QueryPress Pro section.

Ready to try it?

Download QueryPress for free and have your search running in minutes. If you later want QueryPress Pro, you’ll need this free plugin installed.

Download QueryPress for free