Theme Jug

Directory Submission for a WordPress Plugin Launch

Peach plugin puzzle piece emerging from an open package beside three lavender directory profile cards, separated into dark rounded panels with geometric grids and rings.

A directory entry is often the first place a site owner meets a plugin. That page has to say what the plugin does, who it is for, and where the setup instructions live. Gathering those facts before a form is opened keeps the launch orderly and leaves behind pages that a later reader can actually use.

Name the directory before anything else. WordPress plugin directory submission means handing working software to WordPress.org. Telling launch directories about an associated SaaS or AI tool is another assignment, with its own destinations and its own record. A sound plan keeps the two assignments separate and still gives readers one consistent description of the product.

Distribution and announcement are different jobs

The WordPress.org Plugin Directory stores plugin files. Its developer information says developers send a plugin in for review and, after approval, receive access to a Subversion repository. The plugin and its readme become available through the directory once they are uploaded there. A website address on its own does not finish that process.

Launch directories do something else. They carry a product announcement to an audience that directory has chosen to serve. In a launch plan, treat those entries as introductions to the product website. Their status is not the same thing as whether an installable WordPress plugin is available.

When the plugin joins WordPress to a hosted application, say so in plain terms. Spell out which part runs inside WordPress, what the outside application is responsible for, and whether the person installing it needs an account with that service. A reader who wanted a self-contained plugin should be able to see the dependency before setup begins.

One profile, reused on every form

Write a short reference before the first directory form. The point is consistency. The same product should not pick up a new name, a new audience, or a new core job each time someone submits it. Hold the facts still, then change length and emphasis to match the destination.

  • Product name: Write the public spelling and capitalisation exactly. If the plugin and an associated hosted service use different names, keep both and do not blend them.
  • One-sentence description: Name the person the product helps and the task it performs. Open with that function. Leave out adjectives such as “powerful” or “revolutionary”.
  • Canonical URL: Pick the main public product page for the profile. Store the WordPress.org listing address beside it, so each submission can receive the address that belongs to it.
  • Supporting description: Add a short account of the main workflow, where it stops, and any outside account the user must hold. Mention only features that exist in the release being described.
  • Repeated form fields: While reading each directory, copy its real field labels into the worksheet. Point repeated requests back at the approved profile, and note any instruction that belongs only to that destination.

The checklist makes the information reusable. It does not decide what a destination requires. Read that destination’s own submission page before treating a field as mandatory. If a form asks for something the profile does not cover, check the answer before it enters the shared document.

The readme comes before the announcement

A WordPress.org entry needs documentation that helps someone use the plugin. The Plugin Handbook’s readme guidance says readme.txt controls the directory’s public description. It also covers a short description of no more than 150 characters, with no markup, plus fields for contributors, tags, the tested WordPress version, and the stable tag.

Keep that short description on the principal task. Use the longer description for the workflow and for anything the user must have in place first. If configuration is required, put the steps in the installation section. Do not leave the reader to reconstruct them from feature copy.

Look at how the readme sits next to the plugin files. The handbook says minimum WordPress and PHP requirements are parsed from the main plugin PHP file. Writing a number into a launch worksheet does not change the requirements the software declares.

As a writing check, put the readme, the product page, and the announcement draft next to each other. A feature should mean the same thing in all three. Cut language that makes the product sound wider than the release that was documented.

Eligibility, licensing, and outside services

Read the Detailed Plugin Guidelines before sending the plugin. They call for GPL-compatible licensing, a complete plugin at the time of submission, and responsibility for the files inside the package. Bundled dependencies belong in that same preparation.

The guidelines allow a plugin that interfaces with an external service when the service supplies substantive functionality and the readme documents it clearly. They also cover consent for external communications and documentation of data collection. A plugin tied to a service therefore needs a precise account of that connection, not only a sentence that announces the wider product.

For an internal review, follow one ordinary user task from installation through to a finished result. Note where WordPress hands work to the service, what the user has to configure, and what happens if the connection is down. Turn those notes into setup and troubleshooting text.

The WordPress.org submission itself

The official Add your plugin page is the place for a WordPress.org submission. It requires a login before upload. It says submissions are reviewed by hand for common errors and for compliance with the guidelines. It also explains that the plugin name shapes the directory URL, which makes the name a decision to settle before the file is sent.

That page names unescaped output, unsanitised data, and form processing without a nonce among the problems reviewers often see. Those belong in the technical preparation. A careful description will not repair a problem in the code.

Keep a copy of the release that was submitted, with a dated note that identifies it. When review comments arrive, tie each reply to the change it produced, so the person who maintains the plugin can follow the thread later.

After approval, finish the repository upload the distribution process describes. Then open the public entry and walk the installation path. Write down submission, approval, repository upload, and public availability as separate events. An announcement should name the stage that has actually been reached.

When a launch-directory campaign belongs

A WordPress utility that stands on its own does not have to be described as a SaaS product in order to support an announcement. Pick destinations whose stated scope matches what was built. If the product does include a SaaS or AI tool, the profile should explain the wider application and the part the plugin plays in it.

Launch Backlinks prepares one product profile and submits it to launch directories for a SaaS or AI tool, then reports where it submitted.

Keep that submission work on the announcement checklist. The developer who owns the WordPress.org release still has to look after the plugin package, the review correspondence, the repository, and the documentation.

A row for every destination

A simple worksheet is enough: one row for each destination. Record the directory name, the date of submission, the profile version, the destination URL that was supplied, the confirmation that came back, and any follow-up that was asked for. Add the public listing address only after that page has been opened.

Leave “submitted” and “published” as different statuses. A confirmation records that something was sent. A public page is what can be inspected. On that page, look at the product name, the description, the category where one exists, and the outgoing destination. Fix a misleading dependency statement, or a link that points at the wrong product page, before that entry is used as a reference.

For a plugin tied to a service, look hard at the next step. A person who arrives from a launch listing may need an overview of the application. A person who arrives at the plugin entry needs installation guidance. Each landing page should be useful for the reader who starts there.

Save the exact description that went to each destination. If a directory shortens it, read the shorter version for context that disappeared. A sentence can still be grammatical after it loses the detail that explains an account requirement, or that separates the plugin from the application beside it.

A last pass for consistency

Before the release is announced more widely, read the public pages the way a prospective user would. Is the main function visible without decoding marketing language? Is the relationship to an external service obvious? Does the next link lead to a useful explanation or to an installation route?

Set those pages against the approved profile and the release notes. Correct inaccurate wording at its source, then carry the correction into the listings it affects. Keep a dated note of what changed, so a later launch does not reuse a description that is no longer true.