Free WordPress documentation plugin

A WordPress documentation plugin that keeps old links working.

Publish docs for one product or many under clean URLs. Rename or reorganize and PimiDocs redirects the old addresses for you.

Free · GPLv2 · WordPress 6.0+ · PHP 8.0+ · Updates arrive in your WordPress dashboard

1 or manyproducts, each with its own base path
Automatic 301swhen a base path or mode changes
10 blocksfor the Site Editor
llms.txtplus a Markdown copy of every article

What you get

Everything a docs site needs, nothing you have to configure twice.

Single or multi product

All docs under /docs/, or one base per product such as /docs/product-a/ and /help/product-b/.

Old URLs keep working

Change a base path or switch modes and requests to the old address are 301-redirected to the new one.

Categories per product

Nested, orderable categories shown as groups on each docs home. Two products can share an article slug.

Instant search

Visitors type a question and jump straight to the matching article.

Site Editor blocks

Breadcrumbs, category grid, product list, search, previous/next and more. Classic themes override PHP templates instead.

SEO built in

BreadcrumbList JSON-LD, a docs sitemap in wp-sitemap.xml, and TechArticle schema when Yoast SEO is active.

For AI assistants

Readable by ChatGPT, Claude and coding agents.

Add .md to any article URL for a plain Markdown copy. Your docs home serves one llms.txt that lists every article. Both are linked from the page head, so tools find them on their own.

  • Only published articles are listed
  • Markdown copies are noindex with a canonical to the article
  • A root llms.txt on your site is never touched

Switching plugins?

Move from weDocs or BetterDocs without losing a link.

The migration wizard shows a plan before it changes anything, then imports articles and categories and records a redirect for every old URL. A verify step checks each redirect lands on the right page.

Read the migration guide →
wp pimidocs migrate --from=wedocs
wp pimidocs migrate --from=wedocs --apply
wp pimidocs migrate --from=wedocs --verify

The same migration from WP-CLI: dry run, apply, verify.

Set-up

Installed in five minutes.

  1. Download the ZIPUse the button on this page.
  2. Upload and activatePlugins → Add New → Upload Plugin.
  3. Check permalinksSettings → Permalinks must not be “Plain”.
  4. Choose a mode and base pathPimiDocs → Settings, then publish your first article.

Needs WordPress 6.0 or newer (6.7 for the Site Editor blocks) and PHP 8.0 or newer. Updates are offered in Dashboard → Updates like any other plugin. Installation guide →

Questions

Common questions.

How do I change a base path?

PimiDocs → Settings. The old base is kept in a history list and requests to it are 301-redirected to the new address.

Can I switch between single and multi product mode?

Yes. The previous bases are retired into the redirect history, so existing links keep working.

Can two articles have the same slug?

In multi product mode, yes, as long as they belong to different products.

Does it work with my theme?

Block themes design the docs views in the Site Editor. Classic themes copy any template into a pimi-docs/ folder in the theme.

What happens if I uninstall?

Only the plugin’s settings are removed. Articles, categories and products stay in your database.

Running in production

PimiDocs runs the documentation you are reading on this site.

The same plugin powers the docs for every W4DEV plugin and for LoxoWP.