How to choose tags for a WordPress.org plugin
Oct 28, 2026
Tags look like the least important line in your readme, but you only get five, and each one decides two things: which searches can find your plugin, and which tag pages list it. This guide is about choosing those five well. How search scores tags against your name and short description is covered in How to choose a plugin name, short description and tags that search can find; here the question is which tags to pick and how to tell whether one is worth a slot.
Five tags, and the rules around them
WordPress.org’s readme documentation asks for one to five tags, and its plugin guidelines count more than five as spam. Only the first five are used, so a sixth does nothing except risk a note from the plugin review team.
Three more rules from WordPress.org narrow the choice:
- No competitors’ names. The guidelines allow related products as tags, but not competitors: an alternative to Akismet may not use “akismet” as a tag. A WooCommerce add-on can use “woocommerce”; a rival shop plugin can’t.
- No tags only you use. Tags unique to one plugin aren’t shown, so your brand name as a tag is a wasted slot.
- No repetition. Using the same term over and over counts as keyword stuffing, which the guidelines forbid. Five tags that say the same thing five ways cover one idea.
TrackWP’s Readme Checker fails a listing with no tags and warns with fewer than three or more than five.
What a tag does for you
It can supply a search word. WordPress.org only returns plugins whose text contains every word of the search. A tag counts as text, so it can carry a word your name and short description lack.
It puts you on a tag page. Every tag has its own page on WordPress.org listing the plugins that use it, and your plugin page links to each of your tags. People browsing a category land there. Like search, though, the first page goes to the established plugins, so a tag page is only a real source of visitors where you can stand near the top.
It tells people what the plugin is. The tags show on your plugin page. Someone comparing three plugins reads them as a summary.
Broad or narrow: look at the numbers
Tag sizes vary enormously. Here are some, counted on TrackWP’s tag pages on October 28, 2026, among open plugins:
| Tag | Plugins |
|---|---|
| woocommerce | 10,127 |
| seo | 2,828 |
| security | 1,756 |
| contact form | 789 |
| forms | 666 |
| booking | 651 |
| GDPR | 639 |
| calendar | 607 |
| form | 555 |
| backup | 376 |
| 343 | |
| invoice | 220 |
| cookie | 182 |
| table of contents | 108 |
| appointment | 106 |
A few things stand out.
Broad tags are crowded. On a tag with thousands of plugins, a new plugin starts thousands of places down. A broad tag still earns its place when it’s the word people use for your category, because it makes sure you match searches that need it. Just don’t expect visitors from its tag page.
Narrow tags are where you can lead. “Appointment” has about a sixth as many plugins as “booking”. A booking plugin built for appointments has a far better chance of the first page on the narrower tag.
Near-duplicates are separate tags. “form” and “forms” are two tags with two different lists, 555 and 666 plugins. Search treats word forms as the same word, so for search one of them is enough. For tag pages, they’re different shelves. Pick the one your audience’s plugins use, and don’t spend two slots on both.
A balanced set for most plugins: one or two broad tags that place you in the right category, and three or four narrower ones that describe what makes your plugin different, ideally covering searches your name and short description don’t.
Check the competition on each tag
Before you commit to a tag, look at who’s already there.
The tag’s page on TrackWP. Open /plugins/tag/ followed by the tag, for example /plugins/tag/appointment. It lists every open plugin with that tag in WordPress.org’s popular order, with installs, downloads, ratings and rank history. If the top ten are all 100,000+ installs and released last month, that shelf is taken. If several leaders haven’t had a release in a year, there’s room.
Your position in each tag. Every plugin page on TrackWP shows where it stands among the plugins sharing each of its tags, also in popular order: “#4 of 607 in calendar”, with that tag’s leader beside it. If you rank in the top ten for one tag and 400th for another, the second one is doing little for browsing. Check whether it still carries a search word before you replace it.
Niche Research. For a tag you’re weighing up, Niche Research shows its size, how concentrated installs are in the top plugins, leaders that are ageing, newcomers, and a verdict. TrackWP also tracks every tag’s week-on-week downloads, so you can see whether a category is growing or shrinking before you move into it.
Changing tags without losing searches
Tags are among the easiest things to change: they’re a readme edit, with no new code needed. WordPress.org shows the readme from the version in your Stable tag, so edit the readme in that tag’s folder as well as in trunk, or the change won’t appear until your next release.
The risk is dropping a word. If you rank for a search and the only place one of its words appears is a tag you remove, you drop out of that search entirely, not just a few places. Before you change anything:
- List the searches you rank for. The Keyword Tracker shows where you sit in the top 100 for any search.
- For each one, check that every word is still somewhere in your name, short description or remaining tags.
- Change one or two tags at a time, not all five, so you can tell what caused any move.
- Watch your positions for a week. Positions move for other reasons too, so a week tells you more than a day.
TrackWP records every change to a plugin’s tags in its change log, with its popular rank the day before and in the week after. For a plugin you track, it adds your tracked searches before and after, so a search lost to a missing word shows up next to the change that caused it.
A quick checklist
- Five tags, no more.
- No competitors’ names and no tags only you use.
- One or two broad tags for your category, three or four narrower ones where you can stand near the top.
- Not both “form” and “forms”, or any other near-duplicate pair.
- Each search you care about has all its words in your name, short description or tags.
- Edit the readme in your Stable tag’s folder, and change one or two tags at a time.
Once your tags are right, the order on tag pages and in search comes down to the six factors WordPress.org multiplies your score by: How to rank higher in WordPress.org plugin search goes through each one.