WordPress Plugin Readme Copywriting

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.

Get in touch to book

See what this looks like in action

StellarPay Plugin Readme

A full readme rewrite written from scratch to encourage more downloads.

View as image

Orderable Plugin Readme

Complete rewrite to better target the right search terms, reduce confusion, and promote Pro features naturally.

View as an image

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.

Pricing

WordPress plugin readme

£350-500 per readme

(Price range depends on how well I know your plugin before I start.)

Research
Writing
Formatting
Internal links
Upload-ready file

If you have multiple plugins, package pricing is available.

Get in touch to book

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.