orravo.com / migrate

bbPressOForum

Move forums, topics, and replies from bbPress' custom post types to OForum's schema with a built-in importer. About an hour for a forum under 5,000 topics; longer for active communities.

~60 minutesMedium risk↗ Compare bbPress vs OForum

Read this first

Migration is one-way and rewrites permalinks. URL structure changes from /forums/topic/… to /oforum/thread/… by default — set up redirects (step 6) before going live to avoid SEO loss.

The migration, step by step

  1. 1

    Back up your database

    5 min
    Non-negotiable. bbPress data lives in wp_posts and wp_postmeta with custom post types. Take a full DB snapshot before running the importer in case anything misfires.
    wp db export pre-oforum-migration.sql --add-drop-table
  2. 2

    Install OForum + activate

    2 min
    Upload the OForum zip → Activate → paste your license key.
  3. 3

    Run the bbPress importer

    15–45 min
    OForum → Tools → Import → Select bbPress. The importer maps:
    • bbPress forums → OForum rooms
    • bbPress topics → OForum threads
    • bbPress replies → OForum replies
    • User assignments preserved
    Progress shows live; for large forums, leave the tab open until completion.
    # Or via WP-CLI:
    wp oforum import bbpress --batch=200
  4. 4

    Migrate moderators + roles

    5 min
    bbPress moderator role doesn't exist in OForum. Manually add OForum's "Moderator" trust level to anyone who had bbPress moderation rights. Users → bulk edit by user search → assign role.
  5. 5

    Update your menu links + theme

    5 min
    Replace any "Forums" menu items pointing at /forums/ with the new OForum index URL (default /oforum/, customizable in Settings). If your theme has bbPress-specific templates (e.g. bbpress.php), they can stay — OForum doesn't collide with them.
  6. 6

    Set up 301 redirects to keep your SEO

    15 min
    OForum → Tools → Redirect Map auto-generates a list of old bbPress URLs and their new OForum equivalents. Either install a redirect plugin (or use Orravo SEO Recovery Kit if you have it) and bulk-import the list, or paste the entries into your .htaccess / nginx.conf.
  7. 7

    Disable bbPress

    1 min
    Once redirects are live and a couple of forum threads load correctly, deactivate bbPress. Keep installed for two weeks as fallback.

Watch out for

Custom bbPress shortcodes / widgets

bbPress widgets ("Forums List", "Recent Topics") don't auto-replace. OForum has equivalents — drop them into the same widget areas after migration.

Subscriber notification preferences

Per-topic email subscriptions in bbPress migrate as data, but OForum's notification engine is different (digest + per-thread). The first email from OForum after migration includes a "review your subscriptions" link so users can adjust.

BuddyPress integration

If you ran bbPress alongside BuddyPress, BuddyPress activity items pointing at old topic IDs may break. OForum has a BuddyPress sync addon (separate plugin) that rewrites links.

Try before you migrate

14 days of OForum, no card.

Spin up OForumon a staging site or a single page first. Move data only when you’ve confirmed it works for you.

Try free · 14 days · no card

OForum details →

Checkout is briefly offline while we migrate processors.

Stuck mid-migration? Reply to hello@orravo.com — we’ll walk through it with you.