A keyword scan is the core action in WhoKnew Directory SEO™. It queries the WordPress.org Plugin Directory and returns your plugin’s exact position for each keyword you add. Here’s how to run one from start to finish.
Open the Scan Tab
Go to WhoKnew Directory SEO → Scan. The hero title reads Scan Plugin Rankings — “See exactly where you rank in the WordPress.org Plugin Directory for any keyword.”
Step 1 — Select a Plugin
Under the Which plugin? card, choose your source mode:
- My Installed Plugins — pick from a dropdown of plugins already active on this WordPress site.
- Any WordPress.org Plugin — search by slug (e.g.
contact-form-7) or plugin name. Use this to scan a competitor or any plugin not installed here.
Step 2 — Add Keywords & Set Language
Under the Keywords & Language card:
- Type a keyword into the Keywords field and press Enter or comma to add it. Each keyword is shown as a chip — click the × on any chip to remove it.
- Add as many keywords as you need — each keyword costs 1 credit and is scanned in sequence.
- Set the Language dropdown to your target locale (the locale you set in Settings is the default).
Tip: Use multi-word phrases, not single words. “WooCommerce product labels”, “login page customizer”, and “bulk user editor” are the kind of terms real developers type into the Plugin Directory search bar.
Step 3 — Optionally Mark as Competitor
If you’re scanning a competitor plugin, check Track as competitor before running. Competitor plugins are shown with a badge in your Rankings dashboard so you can compare positions at a glance. The Tracked Competitors section at the bottom of the Scan tab lists all plugins you’ve flagged.
Step 4 — Run Scan
Click Run Scan. WhoKnew™ queries WordPress.org for each keyword and records the results. Most scans complete within a few seconds. Results are saved automatically and immediately visible in the Rankings tab.
Credit Cost
Each keyword in a scan costs 1 credit — so scanning 5 keywords in one run costs 5 credits. The running credit count is shown in the pill indicator at the top of the page. Check your balance any time in Usage.
Need Help?
To understand what the results mean after the scan, see Understanding Scan Results. For tracking a competitor plugin, see Tracking Competitors. For credit balance and resets, see Understanding Credits.