Migrate / BetterDocs

Every knowledge base becomes a product.

BetterDocs already lives in this WordPress install, so there is no export file and no ZIP. The importer reads the docs post type and doc category taxonomy straight from your database, and if you run multiple knowledge bases it can import them one at a time into separate products.

No export file Nothing in BetterDocs is modified Images already in your library

Why people move

A knowledge base and product documentation are different jobs.

BetterDocs is good at what it does, and it has a free version we do not. People move when their docs start needing things a knowledge base was never meant to do.

Readers are on older releases

This is the usual reason. Each product gets independent version sets, a switcher in the topbar, and a banner when someone is reading an older version.

Your theme is in the way

BetterDocs renders through templates and the customizer, so docs inherit your theme. WP Super Docs runs in its own HTML document on its own URL.

You publish release notes

Per product changelogs with an RSS feed, and a script tag that drops a what is new widget with an unread count into your own application.

Structure

Multiple knowledge bases, multiple products

BetterDocs organises docs with a category taxonomy, and its Pro version adds knowledge bases on top. Both survive the move, and the knowledge base filter is what lets you split a single install into several products.

  • One knowledge base per run. Filter to a knowledge base and point it at its own product. Repeat for the rest.
  • Categories match by slug. Created if new, reused if they already exist, so a rerun does not duplicate them.
  • Order is kept twice over. Categories come across in term order and docs in menu order.
In BetterDocs
Payments APIKnowledge base
Getting startedDoc category
IntroductionDoc
QuickstartDoc
Core conceptsDoc category
AuthenticationDoc
In WP Super Docs
Payments APIProduct
Getting startedCategory
IntroductionDoc
QuickstartDoc
Core conceptsCategory
AuthenticationDoc

Running one knowledge base? Skip the filter and import the lot.

The process

Detected on its own, run in under a minute

If the docs post type and doc category taxonomy both exist and there is at least one published doc, the importer shows up ready to go.

  1. 1
    Create a product Somewhere for the docs to land. If you run several knowledge bases, make one product per knowledge base.
  2. 2
    Filter by knowledge base, or do not Running BetterDocs Pro with several knowledge bases? Pick one. Running a single one? Leave the filter off and import everything.
  3. 3
    Set the two toggles Overwrite decides what happens when a slug already exists. Include drafts decides whether unpublished BetterDocs articles come with.
  4. 4
    Run and read the counts Created, updated, and skipped totals come back, plus any category errors, so you know exactly what happened.
Import from BetterDocs Detected
Payments API
Payments API handbook
Overwrite existingUpdate docs whose slug already matches
Include draftsBring unpublished BetterDocs articles too
58created
0updated
3skipped

Three slugs already existed. Rerun with overwrite to update them.

Before you run it

What comes across, and what to watch

Because BetterDocs is in the same install, this is one of the two cleanest migrations. Three things are still worth knowing first.

Comes across

  • Title, slug, content, and excerpt
  • Doc categories, created or reused by slug
  • Category term order and doc menu order
  • Published and draft states, mirrored from the source
  • Knowledge bases, one per run, into separate products
  • Images, already. Same install means the same media library, so nothing needs rehosting

Watch for these

  • Published stays published. A published BetterDocs article arrives as a published doc, live the moment the import finishes. Import into a product you have not linked yet, or mark it internal only until you have reviewed it.
  • Categories flatten to one level. Docs land under the category they belong to. If you nested doc categories inside each other, check the result before publishing.
  • Decide who owns the docs URL. Both plugins can want a docs base. Settle that before the import, and add redirects from the old URLs if they ranked.

Questions

Before you start

Does this change anything in BetterDocs?

No. The importer only reads from the BetterDocs post type and taxonomy, and writes into its own. Keep BetterDocs running until you are happy with the result.

I only have the free version. Does it still work?

Yes. Knowledge bases are a Pro feature, so on the free version there is nothing to filter by. Leave that field empty and every doc category comes across.

What if I run it twice?

Docs are matched by slug. With overwrite off they count as skipped and are left alone. With overwrite on they are updated in place rather than duplicated.

Can I keep both plugins installed?

During the migration, yes, and you should. Afterwards it is cleaner to deactivate BetterDocs so there is no question about which plugin owns your docs URL.

What happens to my images?

Nothing needs to happen. BetterDocs stores images in the same WordPress media library and the content keeps pointing at them.

Can I try before I buy?

Tell us how many knowledge bases and categories you have and we will tell you honestly how it will land. There is a 14 day money back guarantee behind the purchase either way.

Next step

Nothing to export. Nothing to lose.

Your BetterDocs content stays exactly where it is until you decide otherwise. There is a 14 day money back guarantee behind the purchase.

BetterDocs is a trademark of WPDeveloper and is not affiliated with Nahnu Plugins. Behaviour described here reflects WP Super Docs version 1.5.75.

Save to list

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only