RankFloRankFlo

Migration guide

Migrate from Contentful to RankFlo

Cut your Contentful bill by 90%+ — same headless flexibility, none of the lock-in.

Start free trialRead docs

Why move from Contentful

  • Contentful Pro starts at $489/mo. RankFlo is free to self-host or $5/mo managed.
  • Open source — no vendor lock-in
  • Built-in AI content generation, real-time SEO scoring, and analytics
  • Type-safe tRPC API alongside REST — Contentful is REST-only
  • Generous rate limits — Contentful throttles aggressively at lower tiers
  • No per-API-call billing — RankFlo doesn't charge per request

Things to plan for

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

Content models & rich text

Contentful uses content models (similar to schemas). Map each model to a RankFlo project. Contentful's rich text format converts cleanly to RankFlo blocks.

References between entries

Contentful supports linked entries (e.g., a blog post → an author entry). The importer preserves these as relations using tags.

Multiple environments

If you use Contentful's Master + Preview environments, plan one RankFlo project per environment, or use the draft/published distinction RankFlo provides natively.

Step-by-step migration

5 steps. Export format: JSON via Contentful CLI

  1. 1

    Install Contentful CLI

    5 min

    npm install -g contentful-cli. Then run contentful login.

  2. 2

    Export your space

    5–30 min depending on space size

    contentful space export --space-id YOUR_SPACE_ID. Outputs a contentful-export-*.json file.

  3. 3

    Run the Contentful importer

    10 min

    Settings → Import → Contentful (JSON). Upload the export file. We map content types to projects and entries to posts.

  4. 4

    Re-host assets

    Contentful assets are hosted at images.ctfassets.net. The importer fetches and re-uploads to RankFlo's storage.

  5. 5

    Update your frontend

    Replace Contentful Delivery API calls with RankFlo's REST endpoints. The shape is similar — fields like fields.title, fields.body translate directly.

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 Contentful?

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

Start freeSee all migration guides