WordPress.org readme copy that increases installs
Your plugin might be free, but your plugin page on WP.org has huge potential
A well-structured, well-written readme can:
- Help your plugin rank in Google and WordPress.org search.
- Drive up installs (which lead to ratings, feedback, and feature requests).
- Act as a stepping stone to your Pro version or upsells.
- Get picked up by language models like ChatGPT and Google AI Overviews.
The problem? Most readmes don’t do any of this.
They’re rushed, outdated, or copied from elsewhere. They don’t tell users why your plugin is worth installing, and they definitely don’t sell the upgrade.
That’s where I come in.
I write, structure, and format plugin readmes that are built to perform. Based on real research, written in plain English, and ready to upload with no extra work from you.
What you’ll get
A complete, upload-ready readme that’s built to improve visibility, drive installs, and support conversions.
Keyword research and competitor scan
I’ll analyse what your audience is searching for, how your plugin fits in, and where your positioning could be stronger.
Clear, benefits-led plugin description
Tailored messaging that quickly explains what your plugin does, why it matters, and who it’s for.
Full feature list + Pro upsell copy
I’ll include your features in a readable format and add clear, persuasive Pro prompts (if relevant).
SEO-ready structure
Formatted to rank well on WordPress.org and Google. This includes proper heading hierarchy, keywords, and natural language for LLM discoverability.
Strategic internal links
To docs, support, demos, or blog content. Helping users get what they need and move forward.
Stylised screenshots
Branded screenshots that show your plugin in action.
Upload-ready formatting
The final .txt file is properly spaced, structured, and formatted to look great on your WordPress.org page.
See what this looks like in action
StellarPay Plugin Readme
A full readme re-write written from scratch to encourage more downloads.
Orderable Plugin Readme
Complete rewrite to better target the right search terms, reduce confusion, and promote Pro features naturally.
Pricing
£400-500 per readme
Price range depends on how well I know your plugin before I start.
Includes everything above: research, writing, formatting, screenshots, and delivery in upload-ready format.
If you have multiple plugins, package pricing is available.
Frequently Asked Questions
Can you work from an existing readme and just improve it?
Yes. I’ll assess what’s already there and either improve it directly or rewrite key sections from scratch.
Can you write the short description for WordPress.org too?
Absolutely. I’ll provide this along with the full file, it’s an important ranking signal.
Do you need plugin access to do this?
Yes. It’s important that I have the latest version of the plugin so I can get to know it properly. This is also needed for screenshots. Because it’s a free plugin though, this is straightforward.
Do you also take care of the plugin banner and icon?
This isn’t something I typically do myself, however, I can give design direction. This is what I did for Orderable’s readme. The designer then took my suggestions and created the images.
Want a readme that gets more installs?
Let’s make it happen.