Listings and review
What goes into a listing and what a reviewer checks before it goes public.
What a listing needs
The Review tab of the listing editor shows exactly what is missing, and submitting is refused until the list is complete. The requirements differ for paid and free listings.
| Requirement | Paid | Free |
|---|---|---|
| Stripe connected | Yes | No |
| At least one price | Yes | No |
| A description of 200+ characters | Yes | Yes |
| A docs link | Yes | Yes |
| A real screenshot | Yes | Yes |
| A refund policy | Yes | No |
| A jar release | Optional | Yes |
A listing also needs a name, a tagline of at least 10 characters and a category before it can be saved. Free listings need a jar because that is what people come for; they are reviewed and scanned exactly like paid ones.
Screenshots and icon
- Up to 8 screenshots per listing, PNG, JPEG or WebP, under 5 MB each. SVG is not accepted.
- Every screenshot needs alt text of at least 4 characters that says what it shows.
- The icon must be square and at least 32 by 32 pixels.
- Screenshots must be real: the plugin running on a server. Generated or stock images are not accepted.
What reviewers check
A person reads every listing before it is public. They look at:
- The author. Your connected GitHub profile, with live signals such as account age, repositories and followers, next to the listing.
- The listing itself. That the description is honest, the docs are public and the screenshots show the real plugin.
- The jar, if you uploaded one. The scanner report for each release, then the file. No repacks, no low-effort AI builds and no obfuscated surprises. See Releases and the jar scanner.
- Support and refunds. A support channel, and an answer to refund requests within 72 hours. Buyers cancel from their Peakstone account and keep access until the paid period ends.
After you submit
The listing moves to review. When a reviewer publishes it, it appears in the catalogue. If they ask for changes, their note is shown on your dashboard and the listing goes back to you.
The first listing a reviewer publishes makes you a founding author while founding spots remain. There are 10 in total.
Changing a live listing
You can keep editing a published listing. Switching it between paid and free sends it back to review. A new jar release is reviewed on its own, and nobody can download it until a reviewer approves it.