Getting started with Filter Query Block 4: installation, license and first filter

Get started with Filter Query Block 4

Filter Query Block 4 adds visitor filters to WordPress’s native Query Loop. Start with a searchable category feed, then edit the controls and result cards in the block editor. This guide covers installing Pro, activating your license and creating the first feed.

Before you install

Use WordPress 6.8 or newer and PHP 8.2 or newer. Back up your site before updating an existing installation, and test an update on staging first. Keep a copy of the database as well as the plugin files: restoring older plugin files does not reverse changes you have saved to page content.

Free includes taxonomy filters, Apply, Reset and ordinary pagination for a single post type. Pro adds entry-text search, date ranges, visitor sorting, Load more, Fetch fresh results for cached pages, compatible custom fields and ACF values, numeric filters, authors, multiple post types and advanced Query rules. Install the Free edition, Accomplice Query Loop Filters, from WordPress.org or search for its name under Plugins → Add New Plugin.

1. Install and activate Pro

Sign in to your Filter Query Block account and download the Pro ZIP from Downloads. In your WordPress admin, open Plugins → Add New Plugin → Upload Plugin, select that ZIP and choose Install Now. If WordPress detects the existing plugin, review the versions before replacing it, then activate Pro.

Use one edition at a time. Pro handles the handoff from Free, and existing native Filter Query layouts remain editable. If you are updating from version 3, Pro retains legacy blocks; the update does not automatically convert saved pages to native version 4 blocks. Read the version 4 transition guide before replacing an existing feed.

2. Activate your license

Open your account’s Licenses page and copy the purchased Pro key. In WordPress, open Filter Query Block → License, paste the key and choose Activate License. Confirm the status is active. Free does not require a license key.

If activation fails, check for extra spaces, the license status and the site allowance in your account. The WordPress server must be able to contact the license service. When moving a site, deactivate an old activation you no longer need and activate the destination within your allowance. Keep keys out of public screenshots and posts.

3. Prepare a small content set

Publish a few posts with descriptive titles, excerpts and at least two categories. In the plugin’s admin page, make sure Posts is available to filters. In Free this section is Post types available to filters; in Pro it is Tracked post types. The catalog discovers filter choices from your content, so a category without published posts may not appear.

4. Build the first Filter Query

Edit a page and insert Filter Query Block, or Filter Query Block Pro in Pro. Choose Posts, select Categories and pick a design such as Buttons and cards. The inserted Query, controls and result blocks remain editable.

Select the filter bar and open Edit Filter Query. Use Content for the result source and items per page, Filters for individual controls, and Design for shared appearance. Keep a labelled category control, Search and Reset. Choose Apply changes, then save the page.

Edit the core Post Template inside the Query Loop to change each result card. A linked title and short excerpt make a useful starting point. Keep Query Pagination and Query No Results inside the same Query so visitors can move through results and recover from an empty search.

5. Check the visitor experience

Preview the page and choose a category. Confirm the expected posts appear, combine it with a search, and try a phrase that should return no matches. Reset should restore the starting feed. Check pagination and the browser’s Back button, then repeat on a phone, including Apply and Cancel when the design uses a filter dialog.

If a result is missing, check its publication status, assigned taxonomy and the Query’s selected post type before changing the design. For help with installation or licensing, contact support with the error message and WordPress/PHP versions, without sharing your license key publicly.

Continue with category filters, filter themes and layouts, or a searchable document library.

Supercharge your feeds!

Become part of a growing community of satisfied users. Experience seamless customization, top-notch support, and regular updates. Try it out with our 14-day money-back guarantee.