You just activated WhoKnew Directory SEO™ Free. Here’s exactly what to do in the next five minutes to see your plugin’s ranking position for the first time and start moving it up.
Step 1 — Run Your First Scan
- Go to WhoKnew Directory SEO → Scan.
- Under Which plugin?, choose My Installed Plugins and select your plugin from the dropdown, or switch to Any WordPress.org Plugin and search by slug or name.
- Under Keywords & Language, type your most important keyword into the field and press Enter to add it. Add up to a handful of keywords — each one costs 1 credit and is scanned in sequence.
- Click Run Scan. WhoKnew™ queries the WordPress.org Plugin Directory and returns your plugin’s position for each keyword in seconds.
Tip: Think in phrases, not single words. Keywords like “bulk email sender”, “login security”, or “WooCommerce product tabs” match how real developers search the Plugin Directory.
Step 2 — Read Your Results
After the scan finishes, go to Rankings. You’ll see the Keyword Rankings dashboard with:
- Position — where your plugin ranks in the directory results for each keyword (lower number is better; #1 is the top result)
- Field hits — how many of WordPress.org’s ranking fields your readme covers for that keyword
- Suggestions — which fields are missing and would improve your position if updated
Step 3 — Check Your Credits
Go to Usage to see your Credits this period and Tier. Free accounts get 10 credits per month, which reset automatically on the 1st of every month per root domain. Use them on your highest-priority keywords first.
Step 4 — Explore the Dashboard
- Readme Optimizer — loads your plugin’s current readme.txt and shows field-by-field coverage for your target keyword
- Rankings → How it ranks — an inline panel explaining Phase 1 (relevance) and Phase 2 (quality score) of the WordPress.org algorithm
- Settings — set your default locale and run a connection test
- Go Pro — compare free and Pro feature tiers with pricing
Quick Wins to Try Today
- Add your main keyword to your plugin title — it carries the highest relevance weight.
- Ensure your short description (the line immediately after the readme header block) contains the keyword and is under 150 characters with no HTML.
- Add up to 5 relevant tags in your readme.txt that match real search queries.
Need Help?
For a deeper look at what scan results mean, see Understanding Scan Results. To understand the ranking algorithm, see How WordPress.org Ranking Works. For credit details, see Understanding Credits.