Back to GrowthDex
Growth idea action plan

WordPress plugin Stable Tag, tag folder, and PHP version stay in sync

Align the trunk Stable Tag, the matching `/tags/` release, and the plugin header version before you touch the public plugin page.

rare tactic
Best-fit channelMarketplaces · Engineering · Operations
Stage + contextstable tag · release hygiene · plugin updates · directory accuracy
BudgetFreebudget tier
Suggested operator signalTarget users who complete the tactic’s intended next action

Why this can grow a startup

WordPress parses the Stable Tag in trunk first, then reads the referenced tag folder for the public page, while the download button version comes from the plugin's main PHP file. That split means one casual mismatch can create a stale listing, broken updates, or a page that claims one version while shipping another. Teams often treat this as release housekeeping. In practice it is storefront hygiene because the directory page and the updater depend on the triad staying aligned.

Source-backed example

WordPress says a Stable Tag of `1.2.3` makes the directory parse `/tags/1.2.3/`, warns that the tag folder readme must also carry the correct Stable Tag to avoid update issues, and notes that the visible download version comes from the main plugin PHP file.

Source-reported evidence

Source: WordPress Plugin Handbook: Plugin Readmes · Browse WordPress Plugin Handbook: Plugin Readmes tactics

The public page is chosen from the Stable Tag target, while the visible download version is taken from the main plugin PHP header.

Attributed to the cited source; GrowthDex has not independently verified it. Use this as context, not as a forecast, benchmark, or recommended target.

Evidence scope: claims and metrics are attributed to the linked source; GrowthDex has not independently replicated the reported result. Check the original context and validate fit before applying it. Read the evidence methodology.

MarketplacesEngineeringOperationsstable tagrelease hygieneplugin updatesdirectory accuracy
GrowthDex operator note

When to use it

Use this when Marketplaces, Engineering, Operations is relevant to stable tag, release hygiene, plugin updates and you can run a bounded test with a free budget.

When not to use it

Do not use it as a substitute for customer evidence, a clear owner, or a measurable stop condition. Local platform rules and market behavior still need checking.

How to do it

  1. Choose one target segment and define the exact next action this tactic should prompt.
  2. Adapt the tactic to Marketplaces and Engineering, using evidence from WordPress Plugin Handbook: Plugin Readmes as context—not as a promised result.
  3. Record a baseline for: Target users who complete the tactic’s intended next action. Set a guardrail that would make you pause the test.
  4. Run a narrow pilot and choose a test window that fits the normal decision or use cycle; do not scale before you have observed the full cycle.
  5. Compare the signal with its baseline. Scale only if the intended action improves without crossing the guardrail; otherwise revise one variable or stop and record what you learned.
Next move

Compare a stack for your situation

Compare source-backed tactics against your product, stage, budget and channel strengths, then choose one experiment to test.

Build my stack

Explore the context

Product-Led GrowthMarketplacesEngineeringOperations

Related tactics

Firefox Add-ons source package with build steps before review

Prepare the reviewable source package and build instructions before submission, because Mozilla can reject or block the add-on when reviewers cannot reproduce what shipped.

rareMarketplaces, Operations, Engineering

Chrome Web Store channel inheritance on update

Treat release channels as sticky state, because Chrome publishes updates to the same channel as the last version unless you deliberately change distribution.

rareMarketplaces, Operations, QA

Chrome Web Store deferred publish window after review

Submit for review with deferred publishing when launch timing matters, then use the staged window to line up docs, support, and announcement timing before the listing goes live.

rareMarketplaces, Launches, Operations

Edge Add-ons hidden listing before review push

Keep the extension hidden while certification and setup finish, then unhide after the page, markets, and support surfaces are ready for real discovery.

rareMarketplaces, Launches, Operations

GitHub Marketplace individual owner emails in contact info

Use named individual email addresses in GitHub Marketplace contact info so pricing, payout, and review updates land with someone accountable instead of disappearing into a shared inbox.

rareMarketplaces, Operations, Brand

Google Chat app audience choice before marketplace push

Choose whether the Chat app is private or public before launch prep hardens, because Google says you cannot change that visibility setting after publish.

rareMarketplaces, Onboarding, Operations
Close the loop

Did you launch this experiment?

Report a launch to help us understand which growth ideas founders put into practice.

This report uses a pseudonymous browser ID. Prompts, names, email, or free-text are not included in outcome events.

Advisory bridge

Apply this with an operator

Choose product surfaces that compound distribution without hiding weak activation or retention.

Work with Ian

SOURCE HUB

More tactics from WordPress Plugin Handbook: Plugin Readmes

Explore related GrowthDex examples and evidence connected to WordPress Plugin Handbook: Plugin Readmes.

Open WordPress Plugin Handbook: Plugin Readmes source hub