RankFloRankFlo

Migration guide

Migrate from WordPress to RankFlo

Move from WordPress to a modern, headless platform — no more plugin sprawl.

Start free trialRead docs

Why move from WordPress

  • No more security patches every few weeks (WordPress + plugin CVEs are constant)
  • 10× faster page loads — RankFlo serves static HTML, no PHP rendering on every request
  • AI content generation, real-time SEO scoring, and analytics built in (no plugins)
  • Type-safe API for any frontend — Next.js, Astro, Remix, or stay headless
  • Cookieless analytics, no GDPR consent banner needed
  • Self-host with Docker if you want full control, or use the managed cloud

Things to plan for

Edge cases that come up on most WordPress → RankFlo migrations.

Plugin-specific shortcodes

WordPress posts often contain [shortcodes] from plugins (Yoast, Gravity Forms, page builders). These don't translate. Our importer strips known shortcodes; the rest you'll need to clean manually or rebuild as RankFlo blocks.

Custom post types

If you used CPTs (custom post types) heavily — events, products, etc. — map them to RankFlo projects or treat them as separate Tag taxonomies.

Page builders (Elementor, Divi)

Page-builder layouts don't survive WXR export cleanly. Plan to rebuild key landing pages as RankFlo pages with the block editor — usually faster than wrestling with broken shortcode dumps.

Featured images

Image URLs need to be re-hosted. Our importer will fetch and re-upload featured images during migration.

Step-by-step migration

7 steps. Export format: WXR (.xml) — WordPress's native export format

  1. 1

    Export from WordPress

    5 min

    In WP admin: Tools → Export → All content. Save the .xml file (WXR format).

  2. 2

    Create your RankFlo project

    2 min

    Sign up, create a project, copy your project API key (blg_...).

  3. 3

    Run the WordPress importer

    10–30 min depending on post count

    Settings → Import → WordPress (WXR). Upload the .xml file. The importer parses posts, pages, categories, tags, authors, and media URLs.

  4. 4

    Map authors to RankFlo users

    5 min

    After import, you'll see a mapping screen — match each WP author to a RankFlo team member or create new ones.

  5. 5

    Review imported content

    30–60 min

    Posts come in as drafts so you can review before publishing. Spot-check a sample for shortcodes, broken images, or formatting issues.

  6. 6

    Update your frontend

    1–4 hours

    Point your blog at RankFlo's REST API or use the TypeScript SDK. Examples in our docs cover Next.js, Astro, and plain HTML.

  7. 7

    Set up redirects

    30 min

    WordPress permalink structure (e.g. /year/month/slug/) needs to redirect to RankFlo's structure (e.g. /blog/slug/). Use Cloudflare Page Rules, nginx, or your reverse proxy.

After the migration

SEO and operational checklist — don't skip these.

  • ✓Set up 301 redirects from old URLs to new RankFlo URLs
  • ✓Submit your new sitemap to Google Search Console
  • ✓Verify all internal links resolved correctly
  • ✓Re-add SEO meta titles and descriptions where missing
  • ✓Configure your custom domain and HTTPS
  • ✓Run a crawler (Screaming Frog) against the new site to catch broken links

Ready to leave WordPress?

Start a free trial — the importer ships with every plan.

Start freeSee all migration guides