Custom Query Blocks
by Ronald Huereca · Blocks
Also makes 4 other plugins · 810+ installs across the portfolio →
Map your archives to pages. Map 404 and term archives as well.
Try it live opens a temporary test site in your browser, which can take about 20 seconds to load. Plugins that rely on outside services or a full server may not work completely there.
Health
A 86/100
no flags
Active installs
700+
≈780 estimated
Momentum
+109%
downloads vs prior 30d
Biggest opportunity: Swap “archives” for “custom query”. “archives” isn't earning its slot: you're not in the first 24 results for its own search. “custom query” sits at #8 untagged, close enough for a declared tag to move it up. All five slots are taken, so one has to go.
86 health vs 71 average across 2,522 Blocks plugins
Install conversion
How it's measured →1.9%
of downloads still active
At least 700 of 37K lifetime downloads are still running, in line with its category: the median Blocks plugin keeps 2.1%, across 1,577 plugins.
Downloads count every update, not just first installs, so older and more frequently released plugins read lower. Compare against other Blocks plugins, not across the directory. wp.org reports active installs as the bottom of a band, so the real rate is this or higher.
This plugin shipped 5 releases in the last 12 months, and every existing install that updated counted as another download. wp.org publishes no split between first installs and updates, so we show the raw rate rather than guess at one.
Details
Directory ranking optimization
How it's scored →How well this listing is tuned to rank in WordPress.org search, on the factors an owner controls. Not popularity, optimization.
Excellent listing optimization
Well tuned across the board
Updated 22 days ago
Tested up to WordPress 7.1.4, the current branch or newer
4.6★ over 25 reviews, smoothed to 4.27★
5 of 5 tags set · short description in place
Search visibility
How it's tracked →Directory searches this plugin turns up in, and which way each one is moving. WordPress.org publishes no history of search positions, so this starts the day we first tracked a keyword and never backfills.
35
Momentum
Losing ground
-0.6
Velocity
places per keyword, 28d
14%
Breadth
of keywords climbing, 28d
-0.3
Acceleration
recent half vs earlier
wp.org is where the directory puts the plugin for that search. On merit is where it would sit if results were ranked on rating, support and updates, without the install boost. The last column is how far the wp.org position moved, from our first reading in the last 90 days to the latest.
| Keyword | wp.org | On merit | wp.org move, 90 days |
|---|---|---|---|
| adopt me your tag | #3 | #4 | up 1 |
| custom query | #8 | #16 | 0 |
| query | #13 | #20 | up 1 |
| query block | #8 | #14 | 0 |
| post type block your tag | #24 | #23 | 0 |
| archive | #24 | #18 | down 6 |
| archives your tag | Not in the top 24 | ||
| category grid your tag | Not in the top 24 | ||
| map pages your tag | Not in the top 24 | ||
43 searches this plugin appeared in over the last 90 days, 6 listed. 37 left out as unrelated or noise (years, numbers, stray words). 3 of its tags aren't in the top 24 for their own search.
What to do about it
- Swap “archives” for “custom query”. “archives” isn't earning its slot: you're not in the first 24 results for its own search. “custom query” sits at #8 untagged, close enough for a declared tag to move it up. All five slots are taken, so one has to go.
Daily downloads
Since 5 Oct 2022 · 1,488 days · wp.org + Plugin Pulse archive
30-day downloads
Rolling 30-day volume · peak 1.2K · peaks are release surges
Directory rank vs rivals
wp.org popularity rank over time · higher is better · when a rival's line climbs above yours, they've overtaken you
Rating trend
Star average over time · dips mark rough releases
Health trend
Composite health score, snapshotted daily
Update activity
How busy the existing users are, measured as downloads in the last 30 days for every 1,000 active sites. A spike means a new release everyone's pulling; a long, slow decline means an aging user base that updates less.
Release cadence
Actively maintainedHow often this plugin actually ships. A steady rhythm is the maintenance signal a single "last updated" date can't show.
5
releases in the last 12 months
22d ago
latest release · v5.7.0 · 9 Oct 2026
51
tagged releases on record
Recent releases
What its installed base runs
via wordpress.orgShare of active installs on each version of this plugin. Green is the current release; a big slice on older versions is a user base that has stopped updating.
Estimated active installs
The public count shows “700+”. Our estimate pins where the real number sits.
Crossed into this band 3 months ago and a band this size takes about a year or more to cross, so the real count is still just under 800.
Install history since 28 May 2019
Recent reviews
All reviews on wp.org ↗- ★★★★★ PeterBP3.0y ago
An indispensable plugin for mapping archives to pages, for when archive.php won’t do the trick.
Read on wp.org ↗ - ★★★★★ Jeremi4.4y ago
I don’t generally use the archive mapping features, but the Post Query functionality is the best I’ve found. Would love for it to have a ‘No posts found.’ message option on the front-end, other than that it’s great!
Read on wp.org ↗ - ★★★★★ Ryan Bakker4.5y ago
Very handy in adding small blocks of posts from a taxonomy. Thanks guys 🙂
Read on wp.org ↗ - ★★★★★ Alvaro Gois dos Santos5.5y ago
I get it, it started as a custom Archive page mapping plugin. And it needed a custom query block to be useful in the block editor era. But the custom query block is useful on its own, and it’s really hard to find. A so useful feature for the block editor should be top priority. Not sure how you could make it work, but both features should be detached. Thanks for sharing your work.
Read on wp.org ↗ - ★★★★★ Erica Franz5.7y ago
I installed this plugin to run and output custom queries with the Gutenberg block. That aspect of the plugin is beyond fantastic. However, the mapping feature doesn’t make sense (to me) to include.. it seems like it ought to be its own separate plugin. On top of that, there was no way to disable the mapping functionality and it automatically broke all of my archives. Despite having all options for mapping set to ‘default’ my archives would either throw a 404 or return a page outputting ALL post, page and CPT content. I have no reason to create custom archives and the original reason I installed the plugin doesn’t offer enough value to justify the added work of creating and mapping archive pages.
Read on wp.org ↗ - ★★★★★ Earl_D5.7y ago
Very useful plugin particularly the archive page mapping feature. Really appreciate the archive mapping feature been looking for a way to do that for months. The term grid ability to draw from any and all CPT taxonomies is putsanding feature. Hopefully a few more embellishments to the grid like images will be added. This topic was modified 5 years, 5 months ago by Earl_D.
Read on wp.org ↗ - ★★★★★ koronavirusu5.8y ago
your ideas are great. Someday you will be very successful.
Read on wp.org ↗ - ★★★★★ Joachim5.9y ago
Does everything I need. Good Job!!!
Read on wp.org ↗
Security history
via Wordfence IntelligenceAll 4 disclosed vulnerabilities are patched in the current version (5.7.0). Sites still on an older version should update.
- Patched Medium · 6.4 Custom Query Blocks <= 5.6.0 - Authenticated (Contributor+) Stored Cross-Site Scripting ↗2026-10-12 CVE-2026-108168 Improper Neutralization of Input During Web Page Generation Affects <= 5.6.0 Patched in 5.7.0
- Patched Medium · 6.4 Custom Query Blocks <= 5.5.0 - Authenticated (Contributor+) Stored Cross-Site Scripting ↗2026-02-12 CVE-2026-39575 Improper Neutralization of Input During Web Page Generation Affects <= 5.5.0 Patched in 5.6.0
- Patched Medium · 6.4 Custom Query Blocks <= 5.3.1 - Authenticated (Contributor+) Stored Cross-Site Scripting ↗2024-08-29 CVE-2024-44059 Improper Neutralization of Input During Web Page Generation Affects <= 5.3.1 Patched in 5.4.0
Vulnerability records provided by Wordfence Intelligence. Copyright 2012-2026 Defiant Inc. License and terms.
CVE records: Copyright 1999-2026 The MITRE Corporation. CVE terms of use.
Behavioral tests
via WP HiveAutomated install-time checks, tested on PHP 8.1.12 · WP 7.0.1
Languages
via translate.wordpress.orgTranslated into 5 languages, 0 at 90% or more
AI assistants
How it's measured →Whether ChatGPT and Claude name this plugin when asked the category question, and whether the readme gives them something to quote.
Not measured yet for this plugin’s topics. Its tracked searches are not among the measured topics. See the topics measured so far.
Readme readiness
5 of 8 pass · checked 28 Oct 2026Can an assistant quote this readme? Eight deterministic checks over the wp.org listing, no model involved.
- ! Says what it does Short description names no action; say what the plugin does for the site.
- ✓ Has a FAQ 4 questions in the FAQ.
- ✓ FAQ asks real questions 4 of 4 read like questions a user would type.
- ! Names who it is for Never says who the plugin is for or what they use it for.
- ✓ Names what it works with Mentions Gutenberg.
- ✓ Headings and lists 5 headings and 3 lists.
- ✓ Enough to quote 1,691 characters of description.
- ! Tags match the text Only 1 of 5 tags appear in the text ("adopt-me", "category grid", "map pages", "post type block" missing).
Growth timeline
Install-tier crossings we have observed, and how long each tier took to outgrow
- 2026-08-08 800+ → 700+ down after 10 days in tier
- 2026-07-29 700+ → 800+ up after 5 days in tier
- 2026-07-24 800+ → 700+ down after 1 days in tier
- 2026-07-23 700+ → 800+ up after 23 days in tier
- 2026-06-30 800+ → 700+ down after 4 days in tier
- 2026-06-26 700+ → 800+ up after 3 days in tier
- 2026-06-23 800+ → 700+ down after 240 days in tier
- 2025-10-26 900+ → 800+ down after 164 days in tier
Competes with
The plugins that solve the same job, ranked by shared tags then reach, closest match first. The letter on the right is each plugin's health grade (A best, F worst).
- D Disable Author Archives 10K+ installs · 4.1★ · 1 shared tag B
-
Simple Yearly Archive 6K+ installs · 4.5★ · 1 shared tag A - A Advanced Posts/Page 3K+ installs · 3.6★ · 1 shared tag
-
Collapsing Archives 3K+ installs · 4.0★ · 1 shared tag B -
Sitekit 3K+ installs · 4.0★ · 1 shared tag C - E Expanding Archives 3K+ installs · 4.2★ · 1 shared tag A
Embed this report card
Drop a live Pulse card for Custom Query Blocks into a readme, a review or a deck. It updates itself.
<iframe src="https://plugins.wpmayor.com/embed/post-type-archive-mapping" width="480" height="300" style="border:0" loading="lazy" title="Custom Query Blocks — Plugin Pulse"></iframe> Custom Query Blocks: 700+ active installs, 4.6★ (25 reviews). Plugin Pulse (WP Mayor), as of 2026-10-31. https://plugins.wpmayor.com/plugin/post-type-archive-mapping
Spotted a number that looks wrong? Report a data issue and we'll check it against the source.